This component computes the length of a shadow projected onto a
horizontal plane into the direction that is perpendicular to the
surface azimuth azi.
The parameter azi is the azimuth of the surface
that is perpendicular to the direction of the view. For example, if
azi=Buildings.Types.Azimuth.S, then one is looking
towards South. Hence, in the Northern hemisphere, at noon, the
length of the shadow is negative as one is looking towards
South but the shadow is in ones back. Similarly, for
azi=Buildings.Types.Azimuth.E, there is a shade of
negative length in the morning, and of positive length in the
afternoon. The example
Buildings.BoundaryConditions.SolarGeometry.Examples.ProjectedShadowLength
illustrates this.
For a definition of the parameters, see the User's Guide Buildings.BoundaryConditions.UsersGuide. The surface azimuth is defined in Buildings.Types.Azimuth.
The component requires as parameters the longitude, latitude and
time zone. These can automatically be assigned by setting the
parameter filNam to a weather data file, in which case
these values are read from the weather data file.
realExpression with
noEvent() to avoid spikes in the trajectory. This is
for Buildings,
#626.absFilNam to avoid multiple calls to
Buildings.BoundaryConditions.WeatherData.BaseClasses.getAbsolutePath.
This is for Buildings,
#506.Evaluate=true for parameters lon,
lat and timZon. This is required for
OpenModelica to avoid a compilation error in
Buildings.BoundaryConditions.SolarGeometry.Examples.ProjectedShadowLength.