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 calculate view factors from a point or plane to a set of surfaces. View factors are used in many thermal comfort calculations such as mean radiant temperture (MRT) or discomfort from radiant assymetry.

Inputs

NameIDDescriptionType
Test Pts Or Planes_testPtsOrPlanesA point or plane from which view vectors will be pojected. Note that, if a point is connected, all view vectors will be weighted evenly (assuming no directional bias). However, if a plane is connected, vectors will be weighted based on their angle to the plane normal, producing view factors for a surface in the connected plane. The first is useful for MRT calculations while the latter is needed for radiant assymetry calculations. This input can also be a list of points or planes.Goo
Test Srfs_testSrfsA list of breps, surfaces, or meshes to which you want to compute view factors. Note that by meshing and joining several goemtries together, you can calculate the combined view factor to these geometries.Goo
Contextcontext_Optional context geometry as breps, surfaces, or meshes that can block the view to the _testSrfs.Goo
View Resolution_viewResolution_An interger, which sets the number of times that the tergenza skyview patches are split. A higher number will ensure a greater accuracy but will take longer. The default is set to 0 for a quick calculation.Goo
Parallelparallel_Set to "True" to run the calculation in parallel and set to "False" to run it with a single core. The default is set to "False."Goo
Run It_runItSet to 'True' to run the component and claculate view factors.Goo

Outputs

NameIDDescriptionType
OutreadMe!...String
Srf View FactorssrfViewFactorsA list of view factors that describe the fraction of sperical view taken up by the input surfaces. These values range from 0 (no view) to 1 (full view). If multiple _testPtsOrPlanes have been connected, this output will be a data tree with one list for each point.Goo
View Vec Srf IndexviewVecSrfIndexThe index of the surface that each view vector hit. This can be used to identify which view pathces are intersected by each surface. If no surfaces are intersected, this value will be -1.Goo
View VectorsviewVectorsThe view vectors that were projected from each testPtOrPlane.Goo
View PatchesviewPatchesThe patches of the sphere that each view vector correspond to.Goo
View Patch Base PtviewPatchBasePtThe center of the viewPatches sphere. This can be used to move the view patches between the testPts.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