Grasshopper

algorithmic modeling for Rhino

0 | Ladybug
1 | AnalyzeWeatherData
2 | VisualizeWeatherData
3 | EnvironmentalAnalysis
4 | Renewables
5 | Extra
6 | Developers
7 | WIP

Shading Mask

Component Index > Ladybug > 3 | EnvironmentalAnalysis > Shading Mask

Use this component to see the portion of the sky dome that is masked by context geometry around a given point.
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).
-output

Inputs

NameIDDescriptionType
_centerPtOrPlane__centerPtOrPlane_A point or plane from which the visible portion of the sky will be evaluated. If a point is input here, the component will calculate Sky Exposure (or the fraction of the sky hemisphere that is visible from the point). If a plane is input here, the component will calculate Sky View (or the fraction of the sky visible from a surface in this plane). If no value is input here, the component will assume a point (Sky Exposure) at the Rhino origin.Goo
context_context_Context geometry surrounding the _centerPtOrPlane_ that could block the view to the sky. Geometry can be either a list of surfaces, breps, or meshes (this component converts everything to a mesh for a fast calculation).Goo
orientation_orientation_A number between 0 and 360 that sets the orientation of a vertically-oriented surface for which you want to visualize the sky view. Alternatively, this input can just be the words "north", "east", "south" or "west." This will block out the portion of the sky that is not visible from a vertical surface with this orientation. Note that an input here will project the patches into the plane of this vertical orientation to calculate a Sky View result (overriding any plane input to the _centerPtOrPlane_). The default is set to have no orientation.Goo
overhangProject_overhangProject_A number between 0 and 90 that sets the angle between the _centerPtOrPlane_ and the edge of an imagined horizontal overhang projecting past the point. Note that this option is only available when there is an input for orientation_ above. This allows one to visualise the portion of the sky blocked by an overhang with this projection anle.Goo
leftFinProject_leftFinProject_A number between 0 and 180 that sets the angle between the _centerPtOrPlane_ and the edge of an imagined vertical fin projecting past the left side of the point. Note that this option is only available when there is an input for orientation_ above. This allows one to visualise the portion of the sky blocked by vertical fin on the left side of the point with this projection anle.Goo
rightFinProject_rightFinProject_A number between 0 and 180 that sets the angle between the _centerPtOrPlane_ and the edge of an imagined vertical fin projecting past the right side of the point. Note that this option is only available when there is an input for orientation_ above. This allows one to visualise the portion of the sky blocked by vertical fin on the right side of the point with this projection anle.Goo
--------------------. ...Goo
_skyDensity__skyDensity_An integer that is greater than or equal to 0, which to sets the number of times that the Tergenza sky patches are split. Set to 0 to view a sky mask with the typical Tregenza sky, which will divide up the sky with a coarse density of 145 sky patches. Higher numbers input here will ensure a greater accuracy but will also take longer. The default is set to 3 to give you an error that is usually less than 1% sky view. It is recommended that you use values of 3 or above for accurate results.Goo
_projection__projection_A number to set the projection of the sky hemisphere. The default is set to draw a 3D hemisphere. Choose from the following options: 0 = 3D hemisphere 1 = Orthographic (straight projection to the XY Plane) 2 = Stereographic (equi-angular projection to the XY Plane)Goo
_scale__scale_Use this input to change the scale of the sky dome. The default is set to 1.Goo
bakeIt_bakeIt_An integer that tells the component if/how to bake the bojects in the Rhino scene. The default is set to 0. Choose from the following options: 0 (or False) - No geometry will be baked into the Rhino scene (this is the default). 1 (or True) - The geometry will be baked into the Rhino scene as a colored hatch and Rhino text objects, which facilitates easy export to PDF or vector-editing programs. 2 - The geometry will be baked into the Rhino scene as colored meshes, which is useful for recording the results of paramteric runs as light Rhino geometry.Goo

Outputs

NameIDDescriptionType
contextMaskcontextMaskA mesh of the portion of the sky dome masked by the context_ geometry.Goo
orientationMaskorientationMaskA mesh of the portion of the sky dome masked by the fact that a surface is facing a given orientation.Goo
strategyMaskstrategyMaskA mesh of the portion of the sky dome masked by the overhang, left fin, and right fin projections.Goo
skyMaskskyMaskA mesh of the portion of the sky dome visible by the _centerPtOrPlane_ through the context_ geometry.Goo
--------------------...Goo
contextExposurecontextExposureThe percentage of the hemispherical sky dome masked by the context_ geometry.Goo
orientExposureorientExposureThe percentage of the hemispherical sky dome masked by the fact that a surface is facing a given orientation.Goo
strategyExposurestrategyExposureThe percentage of the hemispherical sky dome masked by the overhang, left fin, and right fin projections.Goo
skyExposureskyExposureThe percentage of the hemispherical sky dome visible through the context_ geometry and the strategy geometry.Goo

© 2018   Created by Robin Rodricks and Andrew Heumann.   Hosted by

Badges  |  Report an Issue  |  Terms of Service