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 given test surface, set of solar vectors,
and context geometry that you want to ensure solar access to. Solar envelopes are typically used to
illustrate the volume that can be built within in order to ensure that a new development does not
shade the surrounding properties for a given set of sun vectors.

Inputs

NameIDDescriptionType
Base Srf_baseSrfA surface representing the area for which you want to create the solar envelope.Goo
Obstacle Crvs_obstacleCrvsList of curves indicating the top borders of our surroundings that are taken into account in calculating the solar collection.Goo
Contextcontext_An optional list of existing context shading objects, which already block solar access and therefore permit a higher solar envelope in their 'wake'.Goo
Sun Vectors_sunVectorsSun vectors representing hours of the year when sun should be accessible to the properties surrounding the baseSrf. sunVectors can be generated using the Ladybug sunPath component.Goo
Grid SizegridSize_A numeric value inidcating the gird size of the analysis in Rhino model units. The smaller the grid size - the more test points( more accurate but slower). Default value is automatically set based on the size of the input _baseSrf.Goo
Max HeightmaxHeight_If there are no obstrucsions this would be the lowest value for the solar collection points. Default value set to 20 meters below the average baseSrf height.Goo
Incrementincrement_A number for the height at which the vector will be incremented duing context intersection calculations. The default value is 1 meter. Note that this value is only used when context is input.Goo
Envelope To RunenvelopeToRun_Set to 'True' if you would like the component to calculate a solar rights boundary and 'False' if you would like a solar collection boundary. The default is set to solar envelope.Goo
Num Of CPUs_numOfCPUs_Number of CPUs to be used for the simulation. Default value would be 1Goo
Run It_runItSet to 'True' to run the component and generate solar collection points.Goo

Outputs

NameIDDescriptionType
Read Me!readMe!Log of the component.String
Envelope PtsenvelopePtsA list of 3d points representing the heights to which the solar collection reaches. Plug into a native GH 'Delunay Mesh' component to visualize the full solar collection boundary.Goo
Envelope BrepenvelopeBrepThe closed volume in which you can build above which the building will have direct solar access to the input sunVectors.Goo

Video Tutorials

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

Report an Issue  |  Terms of Service