pvlib.irradiance.poa_components#

pvlib.irradiance.poa_components(aoi, dni, poa_sky_diffuse, poa_ground_diffuse)[source]#

Determine in-plane irradiance components.

Combines DNI with sky diffuse and ground-reflected irradiance to calculate total, direct and diffuse irradiance components in the plane of array.

Parameters:
  • aoi (numeric) – Angle of incidence of solar rays with respect to the module surface. See aoi. [°]

  • dni (numeric) – Direct normal irradiance, as measured from a TMY file or calculated with a clearsky model. See dni. [Wm⁻²]

  • poa_sky_diffuse (numeric) – Diffuse irradiance in the plane of the modules, as calculated by a diffuse irradiance translation function. [Wm⁻²]

  • poa_ground_diffuse (numeric) – Ground-reflected irradiance in the plane of the modules, as calculated by an albedo model (eg. grounddiffuse()). [Wm⁻²]

Returns:

irrads (OrderedDict or DataFrame) – Contains the following keys:

  • poa_global : Total in-plane irradiance. [Wm⁻²]

  • poa_direct : Total in-plane beam irradiance. [Wm⁻²]

  • poa_diffuse : Total in-plane diffuse irradiance. [Wm⁻²]

  • poa_sky_diffuse : In-plane diffuse irradiance from sky. [Wm⁻²]

  • poa_ground_diffuse : In-plane diffuse irradiance from ground. [Wm⁻²]

Notes

Negative beam irradiation due to AOI > 90° or AOI < 0° is set to zero.

Examples using pvlib.irradiance.poa_components#

Modelling shading losses in modules with bypass diodes

Modelling shading losses in modules with bypass diodes