sunpeek.core_methods.common.shading.calc_sloped_shading

sunpeek.core_methods.common.shading.calc_sloped_shading(collector_tilt, collector_azimuth, collector_gross_length, collector_row_spacing, ground_tilt, ground_azimuth, sun_azimuth, sun_apparent_elevation, aoi=None, max_aoi_shadow=None, min_elevation_shadow=None)

Calculate internal shading for sloped ground, and several related virtual sensors.

Parameters:

• collector_tilt (pint.Quantity) – For sloped grounds, the collector tilt is the angle beta which is complementary to the angle between the collector surface edge and the vertical axis, extending downward to the horizontal. It can be measured, e.g., using a plumb line from the highest point on the edge of the collector surface. Refer to the documentation of shading on sloped ground for figures and more explanations.

• collector_azimuth (pint.Quantity) – Azimuth angle of collectors. Same as array.azim.

• collector_gross_length (pint.Quantity) – Gross length of collectors. Same as array.collector.gross_length.

• collector_row_spacing (pint.Quantity) – The spacing between adjacent rows of collectors, measured along the ground surface. If the ground is tilted, this is not the same as the horizontal distance. Same as array.row_spacing.

• ground_tilt (pint.Quantity) – Tilt angle of sloped ground.

• ground_azimuth (pint.Quantity) – Azimuth angle of sloped ground.

• sun_azimuth (pd.Series) – Sun azimuth angle in radians

• sun_apparent_elevation (pd.Series) – Apparent sun elevation (altitude) angle in radians

• aoi (pd.Series, optional) – The angle of incidence (AOI) between the normal vector of the collector plane and the sun-beam vector.

• max_aoi_shadow (pint.Quantity, optional) – Array is considered shadowed if aoi is greater than max_aoi_shadow. See array.max_aoi_shadow.

• min_elevation_shadow (pint.Quantity, optional) – Array is considered shadowed if sun apparent elevation is less than min_elevation_shadow. See array.min_elevation_shadow.

Return type:

Dict[str, Series]

Returns:

• Dict with str keys and pint-pandas Series as values.

• is_shadowed (pd.Series) – Boolean, True if the array is to be considered as affected by beam shading, taking all modeled effects into account (internal shading, minimum sun elevation angle, maximum allowed aoi).

• internal_shading_fraction (pd.Series) – Floats between 0 and 1. Degree of shading of the collectors due to row-to-row shading, from 0 (not shaded) to 1 (completely shaded).

Notes

Calculation based on [1], [2] and [3].

References

[1]

Bany, J. and Appelbaum, J. (1987): “The effect of shading on the design of a field of solar collectors”, Solar Cells 20, p. 201 - 228 :doi:`https://doi.org/10.1016/0379-6787(87)90029-9`

[2]

J. Appelbaum and J. Bany, “Shadow effect of adjacent solar collectors in large scale systems,” Solar Energy, vol. 23, no. 6, pp. 497–507, 1979, :doi: 10.1016/0038-092X(79)90073-2.

[3]

Zauner, P. et al., (2024): “Internal Shading for Fixed-Mounted Collectors on Sloped Ground”