![]()
Sunlight Obstruction
#
Introduction#
The sunlight obstruction analysis measures the obstruction caused by each obstruction geometry in the scene, in relation to the sun directions in a sun rig, for one or more analysis points. It has many different use-cases, like evaluating where to put greenery in order to reduce sunlight on a plaza or how to shape a massing in order to not shade neighboring buildings.
Set Up#
The analysis can run either using a temporary scene or a static scene where geometry has been added prior to running the analysis.
Geometry Group#
Geometry groups have an intersection type property which decides if the geometry in the group will be treated as target or as obstruction geometry. The sunlight obstruction will only be evaluated for obstruction type geometries, target type geometries will still obstruct the sunlight but won't record any obstruction.
The sunlight obstruction analysis requires at least one obstruction geometry group in order to run. It either has to be supplied through the scene objects parameter, if the analysis is running on a temporary scene, or added to a static scene prior to running the analysis.
Info
Obstruction geometries are transparent meaning that multiple obstruction geometries can record obstruction for the same sun direction. Target geometries are opaque. This means that if a target geometry obstructs a sun direction for an analysis point, no obstruction geometry will record obstruction for that same sun direction and analysis point.
Sun Rig#
The sun rig contains sun directions. It is created using a location and a time pattern that outline the time at which the sunlight should be evaluated.
Analysis Points#
The analysis points specify both the location and the orientation of where the sunlight should be evaluated. An analysis point is usually created on a surface using the normal of the surface as the analysis point direction. Sunlight can not be received from behind the analysis point.
Visibility Mask#
The visibility mask can be used to exclude geometry groups from the analysis. This can be useful when the same scene is used for multiple analyses that require different geometric compositions.
Results#
The results are organised on a per obstruction geometry group, per geometry basis and can be filtered using the geometry group name.
The obstruction score that is reported is the cumulative amount of sunlight obstruction from the specific obstruction geometry, for all analysis points.
