pvlib.pvsystem.PVSystem.get_irradiance#
- PVSystem.get_irradiance(solar_zenith, solar_azimuth, dni, ghi, dhi, dni_extra=None, airmass=None, albedo=None, model='haydavies', **kwargs)[source]#
Uses the
irradiance.get_total_irradiance()
function to calculate the plane of array irradiance components on the tilted surfaces defined by each array’ssurface_tilt
andsurface_azimuth
.- Parameters
solar_zenith (float or Series) – Solar zenith angle.
solar_azimuth (float or Series) – Solar azimuth angle.
dni (float or Series or tuple of float or Series) – Direct Normal Irradiance. [W/m2]
ghi (float or Series or tuple of float or Series) – Global horizontal irradiance. [W/m2]
dhi (float or Series or tuple of float or Series) – Diffuse horizontal irradiance. [W/m2]
dni_extra (float, Series or tuple of 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
irradiance.get_total_irradiance()
.
Notes
Each of dni, ghi, and dni parameters may be passed as a tuple to provide different irradiance for each array in the system. If not passed as a tuple then the same value is used for input to each Array. If passed as a tuple the length must be the same as the number of Arrays.
- Returns
poa_irradiance (DataFrame or tuple of DataFrame) – Column names are:
'poa_global', 'poa_direct', 'poa_diffuse', 'poa_sky_diffuse', 'poa_ground_diffuse'
.