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 with the Ladybug "Radiation Analysis", "Sunlight Hours Analysis", or "View Analysis" component to set up the parameters for an Orientation Study.
You can use an Orientation Study to answer questions like "What orientation of my building will give me the highest or lowest radiation gain for my analysis period?"
Another question might be "What direction should I orient my static solar panel to get the maximum radiation during my analysis period?"
An Orientation Study will automatically rotate your geometry around several times based on the inputs made to this component and the results will be recorded in the corresponding Analysis component that this one is hooked up to.


Division Angle_divisionAngleA number between 0 and 180 that represents the degrees to rotate the geometry for each step of the Orientation Study.Goo
Total Angle_totalAngleA number between 0 and 360 that represents the degrees of the total rotation that the geometry will undergo over the course of the Orientation Study. This _totalAngle should be larger than the _divisionAngle and divisible by the _divisionAngle.Goo
Base PointbasePoint_Input a point here to change the center about which the Orientation Study will rotate the geometry. If no point is connected, the default point of rotation will be the center of the test geometry.Goo
Rotate ContextrotateContext_Input either a Boolean value or a set of context Breps that should be rotated along with the test geometry. If set this input to "True", all context Breps will be rotated with the test geometry. The default is set to "False" to only rotate the test geometry.Goo
Run The Study_runTheStudy[Boolean or GeometryBase] Since orientation study may take a long time, this is an extra confirmation request to make sure that you really want to run the oriantation study! [courtesy of Windows Vista...;)] If you want part of the context to roatate with the test geometry the connect it here!Goo


Orientation Study ParorientationStudyParA list of Orientation Study parameters that can be plugged into the Ladybug "Radiation Analysis", "Sunlight Hours Analysis", or "View Analysis" component.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