sunpeek.core_methods.common.shading.calc_shading_aoi_elevation

sunpeek.core_methods.common.shading.calc_shading_aoi_elevation(internal_shading_fraction, sun_apparent_elevation, aoi=None, max_aoi_shadow=None, min_elevation_shadow=None)

Calculate shading effects caused by large angles of incidence or low sun elevation.

Parameters:

• internal_shading_fraction (pd.Series) – Row-to-row shading fraction.

• sun_apparent_elevation (pd.Series) – Sun apparent 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.

Returns:

is_shadowed – 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).

Return type:

pd.Series.