sunpeek.core_methods.common.shading.calc_BanyAppelbaum_shading_fraction#
- sunpeek.core_methods.common.shading.calc_BanyAppelbaum_shading_fraction(collector_tilt, collector_azimuth, collector_gross_length, collector_row_spacing, sun_azimuth, sun_apparent_elevation, ground_tilt=<Quantity(0, 'degree')>)#
Calculate internal shading (row-to-row shading) of a collector array.
- 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 radianssun_apparent_elevation (
pd.Series) – Apparent sun elevation (altitude) angle in radiansground_tilt (
pint.Quantity, optional) – Tilt angle of sloped ground.
- Return type:
- Returns:
Dict with str keysandpint-pandas Series as valuesinternal_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).
Notes
This algorithm supports tilted ground, but only if ground and collectors have the same azimuth angle. Arbitrary sloped ground is supported by
StrategyInternalShading_SlopedGround.Calculation based on [1].
internal_shading_fraction calculation taken from ADA implementation: sunpeek/sunpeek/uploads/d383e5e42f77516953810e13ac0f42cb/vDP_CollectorField_rd_bT_shaded.m This implementation has been extended and takes component.ground_tilt into account. Not used in algorithms: component pressure, component humidity / dewpoint See also discussion in sunpeek/sunpeek#128
References