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 generate a solar envelope for a closed boundary curve with minimum inputs. This component predefines monthly and hourly ranges in order to simplify the creation of useful envelope geometry.
The solar envelope is used to ensure that its adjacent neighbors (defined as anything outside of the chosen boundary curve) will receive a specified minimum hours of direct solar access for each day in a specified month range of the year.
Any geometry built within the solar envelope boundaries will therefore not cast any shadow on adjacent property for the given hour and month range.
The start and end dates that determine the month range for solar access can be chosen from the following options:
0) Mar 21 - Jun 21
1) Mar 21 - Sep 21
2) Mar 21 - Dec 21
3) Jun 21 - Sep 21
4) Jun 21 - Dec 21
5) Sep 21 - Dec 21
The default set to 4) June 21 to December 21.
Reference: Niemasz, J., Sargent, J., Reinhart D.F., "Solar Zoning and Energy in
Detached Residential Dwellings," Proceedings of SIMAUD 2011, Boston, April 2011.


Boundary_boundaryA closed boundary curve representing a piece of land (such as a property to be developed) for which solar access of the surrounding land is desired.Goo
Location_locationThe output from the importEPW or constructLocation component. This is essentially a list of text summarizing a location on the earth.Goo
Required Hours_requiredHoursThe number of hours of direct solar access that the property surrounding the boundary curve should receive during the _monthRange. For example an input of 4 will define the hour range roughly between 10AM and 2PM. The component will compute the hour range that will maximize the envelope volume. Goo
Northnorth_Input a vector to be used as a true North direction or a number between 0 and 360 that represents the degrees off from the y-axis to make North. The default North direction is set to the Y-axis (0 degrees).Goo
Month Range_monthRangeAn optional interger value to change the month range for which solar access is being considered. The default month range is Jun 21 - Dec 21. Integers input here must be between 0 - 5 and correspond to the following : --- 0 = Mar 21 - Jun 21 1 = Mar 21 - Sep 21 2 = Mar 21 - Dec 21 3 = Jun 21 - Sep 21 4 = Jun 21 - Dec 21 5 = Sep 21 - Dec 21 --- Where, in the North/South Hemispheres, these dates repsectively signify: Mar 21 = Vernal/Autumnal Equinox Jun 21 = Summer/Winter Solstice Sep 21 = Autumnal/Vernal Equinox Dec 21 = Winter/Summer SolsticeGoo


Solar EnvelopesolarEnvelopeA Brep representing a solar envelope. This volume should be built within in order to ensure that the surrounding property is not shaded for the given number of hours.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