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 quickly compute the hourly solar radiation or illuminance falling on an unobstructed surface that faces any direction from EPW inputs.
The calculation method of this component is faster than running a full Ladybug Solar Radiation Analysis but this comes at the cost of not being able to account for obstructions that block the sun.

Inputs

NameIDDescriptionType
Location_locationThe output from the importEPW or constructLocation component. This is essentially a list of text summarizing a location on the earth.Goo
Direct Normal_directNormalA list of 8760 hourly values (with an optional Ladybug header on it) that denotes direct normal solar. This can be either directNormalRadiation or directNormalIlluminance (depending on what output is needed). These values can be obtained from the "Ladybug_Import EPW" component or the "Ladybug_Design Day Sky Model" component.Goo
Diffuse Horizontal_diffuseHorizontalA list of 8760 hourly values (with an optional Ladybug header on it) that denotes diffuse horizontal solar. This can be either globalHorizontalRadiation or globalHorizontallIlluminance (depending on what output is needed). These values can be obtained from the "Ladybug_Import EPW" component or the "Ladybug_Design Day Sky Model" component.Goo
Srf Azimuth_srfAzimuth_A number between 0 and 360 that represents the azimuth that a surface is facing in degrees. A value of 0 means North, 90 means East, 180 means South, and 270 means West. If no value is connected here, a default azimuth of 180 will be assumed for a south facing window.Goo
Srf Altitude_srfAltitude_A number between 0 and 90 that represents the altitude that a surface is facing in degrees. A value of 0 means the surface is facing the horizon and a value of 90 means a surface is facing straight up. If no value is connected here, a default altitude of 90 will be assumed for a surface facing straignt up.Goo
Sky ModelskyModel_Set to "True" to use an isotropic sky model, which assumes that diffuse radiation is evenly distributed across the sky and is suitale for both cloudy and clear skies. Set to "False" to use an anisotropic sky model, that places more diffuse radiation near the solar disc and is more accourate for clear skies but is not suitable for cloudy skies. The default is set to "True" of an isotropic sky model.Goo

Outputs

NameIDDescriptionType
OutreadMe!...String
Srf DirectsrfDirectHourly direct solar falling on the surface.Goo
Srf DiffusesrfDiffuseHourly diffuse solar falling on the surface.Goo
Srf TotalsrfTotalHourly total solar falling on the surface.Goo
Srf DirectionsrfDirectionA vector showing the direction that the surface is facing in the Rhino scene.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