Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

0 | Ladybug
1 | AnalyzeWeatherData
2 | VisualizeWeatherData
3 | EnvironmentalAnalysis
4 | Renewables
5 | Extra
6 | Developers
7 | WIP

Use this component to get information about the sun
This component is based on NOAA's research (National Oceanic and Atmospheric Administration) and it uses equations from Astronomical Algorithms, by Jean Meeus.
"The sunrise and sunset results are theoretically accurate to within a minute for locations between +/- 72° latitude, and within 10 minutes outside of those latitudes."
Special thanks goes to the authors of the spreadsheets Solar Calculation and the web page
This component calculates sunrise and sunset per hourly data. The approximation error of OfficialSunriseSunset could be about one-two minutes.
Despite this component does not consider the leap day (FEB 29th), results are accurate enough.


Location_locationThe output from the importEPW or constructLocation component. This is essentially a list of text summarizing a location on the earth.Goo
HOYor Analysis Period_HOYorAnalysisPeriodConnect: a) a list of HOYs from outputs of the Ladybug_DOY_HOY for specific date; b) OR a list of values from 1 to 8760 for the whole year; c) OR Ladybug Analysis Period for the whole year.Goo
Is Sun UpshiftisSunUpshift_Set the number of hour after the sunrise and before the sunset you intend to exclude from the calculation of isSunUp. If no value is connected, the default value is 0.Goo
Is Sun Up AltitudeisSunUpAltitude_write a conditional statement about solar altitude. Use 'v' as variable. - Here's an example: v > 25.5 and v < 67.3 - It is possible to use the following symbols: and, or, ==, !=, >, <, >=, <=, ), (Goo
Yearyear_A number between -1000 to 3000. The approximations used in these script are very good for years between 1800 and 2100. Results should still be sufficiently accurate for the range from -1000 to 3000.Goo


Official Sunrise SunsetofficialSunriseSunsetIt is the time between day and night when there is light outside and the Sun is on the horizon (90°50').Goo
Solar NoonsolarNoonSolar noon is when the sun is at its highest point in the sky each day.Goo
Solar Elevation CorrectedsolarElevationCorrectedNumber(s) indicating the sun altitude(s) in degrees for each sun position on the sun path. It consider the atmospheric refraction.Goo
Solar AzimutsolarAzimutNumber(s) indicating the sun azimuths in degrees for each sun position on the sun path.Goo
Sun VectorsunVectorVector(s) indicating the direction of sunlight for each sun position.Goo
Is Sun UpisSunUpA list of number. 1 if the sun is up and 0 if the sun is down. - Use Ladybug Analysis Period or a list of values from 1 to 8760 to generate data for the whole year. - Try to connect this output to Ladybug 3D Chart to get a daylight chart of your location.Goo
DatedateDetailied information for each sun position including date and time.Goo
Sun Light DurationsunLightDurationDuration of sunlight per day expressed in minutes. - This output is available just for _HOYorAnalysisPeriod type a) and b) - Try to connect this output to Ladybug_Average Data to create charts of your location using Ladybug_Monthly Bar Chart.Goo

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Ladybug and associated data © 2023 Ladybug Tools.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service