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 see the portion of the sky dome that is masked by context geometry around a given viewpoint.
The component will generate separate meshs for the portions of the sky dome that are masked and visible.
The component will also calculate the percentage of the sky that is masked by the context geometry and the percentage that is visible (the sky view factor).


Test Pt_testPtA view point for which one wants to see the portion of the sky masked by the context geometry surrounding this point.Goo
Context_contextContext geometry surrounding the _testPt that could block the view to the sky. Geometry must be a Brep or list of Breps. You are also advised to provide surfaces instead of solid objects. Providing surfces will make the calculation faster and accurate. So if you are using this component to check the percent of sky visible from a courtyard, please only provide surfaces immediate to the couryard and the not the whole building as a brep.Goo
Sky DensityskyDensity_An integer, that is greater than or equal to 0. This value is used to generate test points on skyDome. from which the maskedSky surfaces are derived. The default value is set to 1. Incresing this value will increase the calculation time. You are adviced to increase this number only if you are trying to analyze too many shading surfaces.Goo
Radiusradius_A float, that controls the radius of skyDome.Goo
Mergemerge_A boolean. Set it to True to merge maskedSky surfacesGoo


Masked Srf On GroundmaskedSrfOnGroundA list of surfaces. These are masked horizontal projections of maskedSky surfaces. They're useful when the skyDome is viewed from the top.Goo
Masked Crvs On SkymaskedCrvsOnSkyA list of Curves. These are edge curves for maskedSky surfaces.Goo
Masked Sky DomemaskedSkyDomeA list of surfaces. The portion of sky not blocked by the context geometryGoo
Unmasked Sky DomeunmaskedSkyDomeA list of surfaces. The portion of sky blocked by the context geometryGoo
Perc MaskedpercMaskedPercentage of the sky blocked by the context geometryGoo

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