pvlib.pvsystem.Array.get_irradiance#

Array.get_irradiance(solar_zenith, solar_azimuth, dni, ghi, dhi, dni_extra=None, airmass=None, albedo=None, model='haydavies', **kwargs)[source]#

Get plane of array irradiance components.

Uses pvlib.irradiance.get_total_irradiance() to calculate the plane of array irradiance components for a surface defined by self.surface_tilt and self.surface_azimuth.

Parameters:

solar_zenith (float or Series.) – Solar zenith angle.
solar_azimuth (float or Series.) – Solar azimuth angle.
dni (float or Series) – Direct normal irradiance. [W/m2]
ghi (float or Series. [W/m2]) – Global horizontal irradiance
dhi (float or Series) – Diffuse horizontal irradiance. [W/m2]
dni_extra (float or Series, optional) – Extraterrestrial direct normal irradiance. [W/m2]
airmass (float or Series, optional) – Airmass. [unitless]
albedo (float or Series, optional) – Ground surface albedo. [unitless]
model (String, default 'haydavies') – Irradiance model.
kwargs – Extra parameters passed to pvlib.irradiance.get_total_irradiance().

Returns:

poa_irradiance (DataFrame) – Column names are: 'poa_global', 'poa_direct', 'poa_diffuse', 'poa_sky_diffuse', 'poa_ground_diffuse'.

Notes

Some sky irradiance models require dni_extra. For these models, if dni_extra is not provided and solar_zenith has a DatetimeIndex, then dni_extra is calculated. Otherwise, dni_extra=1367 is assumed.