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, from
aoi()
.dni (numeric) – Direct normal irradiance (Wm⁻²), as measured from a TMY file or calculated with a clearsky model.
poa_sky_diffuse (numeric) – Diffuse irradiance (Wm⁻²) in the plane of the modules, as calculated by a diffuse irradiance translation function
poa_ground_diffuse (numeric) – Ground reflected irradiance (Wm⁻²) in the plane of the modules, as calculated by an albedo model (eg.
grounddiffuse()
)
- 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^{\circ}\) or AOI \(< 0^{\circ}\) is set to zero.
Examples using pvlib.irradiance.poa_components
#
Modelling shading losses in modules with bypass diodes