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’s surface_tilt and surface_azimuth.

  • 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().


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.


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