sunpeek.core_methods.common.shading.calc_BanyAppelbaum_shading

sunpeek.core_methods.common.shading.calc_BanyAppelbaum_shading(collector_tilt, collector_azimuth, collector_gross_length, collector_row_spacing, sun_azimuth, sun_apparent_elevation, ground_tilt=<Quantity(0, 'degree')>, aoi=None, max_aoi_shadow=None, min_elevation_shadow=None)

Calculate internal shading (row-to-row shading), considering also max aoi and min elevation effects.

Parameters:

• collector_tilt (pint.Quantity) – Tilt angle of collectors. Same as array.tilt.

• 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.

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

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

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

• 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) – Float between 0 and 1. Degree of shading of the collectors due to row-to-row shading, from not shaded (0) to completely shaded (1).