Sunlight Hour
#
Introduction#
The sunlight hour analysis determines the potential number of sunlight hours that an analysis point can be exposed to. The sunlight conditions are specified using a sun rig and only the direction towards the sun is evaluated, weather conditions impacting the sunlight is not taken into consideration.
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#
The sunlight hour analysis requires at least one 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.
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 analysis will output the potential amount of sunlight for each analysis point. The maximum amount of sunlight is governed by the amount of time in the time pattern that is used to create the sun rig. The time pattern also controls the accuracy of the analysis, through the time span setting, which specifies the frequency at which the sun direction should be sampled.