Enzyme Heliodon

Generates a 3D solar dome and hourly sun vectors on the 21st of each selected month (one representative day per month) for environmental analysis.

Site Analysis Nickname: Heliodon

Overview

Generates a 3D solar dome and calculates annual sun vectors for environmental analysis.

Inputs (9)

  • Latitude (Number): Location latitude (-90 to 90)
  • Longitude (Number): Location longitude (-180 to 180)
  • Time Zone (Number): Time zone offset from GMT
  • Radius (Number): Visual radius of the heliodon dome
  • Center (Point): Center point of the heliodon
  • Months (Interval): Domain of months to evaluate (e.g., 1 to 12). A start after the end wraps over the new year (e.g., 11 to 2 = November to February).
  • Hours (Interval): Domain of hours to evaluate (e.g., 8 to 17).
  • Run (Boolean): Optional. False = skip the analysis and keep showing the last results (cached). Share one toggle with the Analysis Dashboard to switch everything on/off together.
  • North (Number): Optional. Angle of true north from the model +Y axis, degrees counter-clockwise (Ladybug convention: 90 = north points to -X). Sun vectors, arcs and points are rotated with it. Default 0 = +Y is north.

Outputs (5)

  • Sun Vectors (Vector): All solar vectors above the horizon (pointing TO the sun).
  • Daily Arcs (Curve): Visual sun path curves for the 21st of each month.
  • Sun Points (Point): Visual hourly sun positions.
  • Base Circle (Curve): A flat circle framing the heliodon radius.
  • Info (Text): Method, assumptions, simplifications and references.

Method, assumptions and simplifications

The same notes appear in the component's Info output.

Method

  1. For the 21st of each month in Months (day of year 21, 52, 80 ... 355) it computes sun positions every 0.5 h on the half-hour grid, from the first half hour at or after the start of Hours to its end, in local standard time. Months is read from start to end; a start after the end wraps over the new year (11 to 2 = November to February).
  2. Sun position uses the NOAA fractional-year formulas: equation of time and declination, true solar time = clock time + equation of time + 4 × Longitude − 60 × Time Zone (minutes), hour angle, then altitude and azimuth.
  3. Positions with Z > 0.01 (altitude above about 0.6°) are kept; whole-hour positions become Sun Vectors (unit vectors pointing to the sun) and Sun Points at Radius around Center.
  4. Daily Arcs are degree-3 curves through the half-hourly positions of each day; Base Circle is the horizontal circle of Radius.

Assumptions

  • Model +Y is true north and +X east unless North is set: North (degrees, counter-clockwise from +Y, Ladybug convention) rotates the vectors, arcs and points about Z.
  • Time Zone is the standard offset from GMT; daylight saving is not applied.
  • Each vector stands for one hour on one representative day per month.

Simplifications and limits

  • Twelve representative days, not every day of the year: summing vectors gives hours on those days, not annual sun hours.
  • No atmospheric refraction; position accuracy is that of the NOAA approximation (around a few tenths of a degree).

Workflow

  • Heliodon Sun Vectors -> Sun Hours Analysis or other shading tools.

References

  • NOAA Global Monitoring Division, General Solar Position Calculations (fractional-year equations).