pvlib.irradiance.get_total_irradiance#

pvlib.irradiance.get_total_irradiance(surface_tilt, surface_azimuth, solar_zenith, solar_azimuth, dni, ghi, dhi, dni_extra=None, airmass=None, albedo=0.25, surface_type=None, model='isotropic', model_perez='allsitescomposite1990', diffuse_components=False)[source]#

Determine total in-plane irradiance and its beam, sky diffuse and ground reflected components, using the specified sky diffuse irradiance model.

\[I_{tot} = I_{beam} + I_{sky diffuse} + I_{ground}\]

Sky diffuse models include:

isotropic (default)
klucher
haydavies
reindl
king
perez
perez-driesse

Parameters:

surface_tilt (numeric) – Panel tilt from horizontal. See surface_tilt. [°]
surface_azimuth (numeric) – Panel azimuth. See surface_azimuth. [°]
solar_zenith (numeric) – Solar zenith angle. See solar_zenith. [°]
solar_azimuth (numeric) – Solar azimuth angle. See solar_azimuth. [°]
dni (numeric) – Direct normal irradiance. See dni. [Wm⁻²]
ghi (numeric) – Global horizontal irradiance. See ghi. [Wm⁻²]
dhi (numeric) – Diffuse horizontal irradiance. See dhi. [Wm⁻²]
dni_extra (numeric, optional) – Extraterrestrial direct normal irradiance. See dni_extra. [Wm⁻²]
airmass (numeric, optional) – Relative airmass, not adjusted for pressure. See airmass_relative. [unitless]
albedo (numeric, default 0.25) – Ground surface albedo. See albedo. [unitless]
surface_type (str, optional) – Surface type. See get_ground_diffuse() for the list of accepted values.
model (str, default 'isotropic') – Irradiance model. Can be one of 'isotropic', 'klucher', 'haydavies', 'reindl', 'king', 'perez', 'perez-driesse'.
model_perez (str, default 'allsitescomposite1990') – Used only if model='perez'. See perez().
diffuse_components (bool, default False) – If True, returns values for the different diffuse irradiance components available from the selected model (e.g., isotropic, circumsolar, horizon brightening). If False, only the total diffuse irradiance is returned. This option is not available for the 'klucher' and 'king' models.

Returns:

total_irrad (dict or DataFrame) – Contains keys/columns 'poa_global', 'poa_direct', 'poa_diffuse', 'poa_sky_diffuse', 'poa_ground_diffuse'. [Wm⁻²] If diffuse_components is True, additional keys/columns are returned for each of the sky diffuse components returned by the selected model.

Notes

Models 'haydavies', 'reindl', 'perez' and 'perez-driesse' require 'dni_extra'. Values can be calculated using get_extra_radiation().

The 'perez' and 'perez-driesse' models require relative airmass (airmass) as input. If airmass is not provided, it is calculated using the defaults in get_relative_airmass().