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.
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
- 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).
- 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.
- 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.
- 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).