sunpeek.core_methods.common.shading.calc_sloped_shading_geometry#

sunpeek.core_methods.common.shading.calc_sloped_shading_geometry(collector_tilt, collector_azimuth, collector_gross_length, collector_row_spacing, ground_tilt, ground_azimuth)#

Calculate auxiliary geometry values, used as inputs for the shadow calculation.

:param Are documented in calc_sloped_shading():

Return type:

Dict[str, Quantity]

Returns:

Dict with these geometry results as Quantities with the following units
theta (Quantity [radians (dimensionless)]) – Ground slope in collector azimuth direction.
epsilon (Quantity [radians (dimensionless)]) – Slope along the collector row (perpendicular to the collector azimuth).
beta (Quantity [radians (dimensionless)]) – Absolute tílt of the collector surface in collector azimuth direction.
a_prime (Quantity [meter]) – Collector gross length in collector azimuth direction.
collector_row_spacing (Quantity [meter])
collector_gross_length (Quantity [meter])
collector_azimuth (Quantity [radians (dimensionless)])
plane_a (Quantity [dimensionless], x-coordinate of the plane's normal vector (see Notes).)
plane_b (Quantity [dimensionless], y-coordinate of the plane's normal vector (see Notes).)
plane_c (Quantity [dimensionless], z-coordinate of the plane's normal vector (see Notes).)
plane_d (Quantity [meter], constant in plane equation (see Notes).)

Notes

Parameters are documented in calc_sloped_shading() The internal shadow calculation needs geometrical values such as absolute collector tilt and collector gross length in the direction of the collector azimuth. However, for practical reasons, these are measured in a different direction (see [1] for details). This method computes the measured input quantities in direction of the collector azimuth. For further calculation, a plane in 3D is required, defined as a*x + b*y +c*z + d = 0, with (a, b, c) being the normal vector of the plane. The coefficients (a, b, c, d) are returned as a dict.

References