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_tiltandsurface_azimuth.- Parameters
solar_zenith (
floatorSeries) – Solar zenith angle.solar_azimuth (
floatorSeries) – Solar azimuth angle.dni (
floatorSeriesortupleoffloatorSeries) – Direct Normal Irradiance. [W/m2]ghi (
floatorSeriesortupleoffloatorSeries) – Global horizontal irradiance. [W/m2]dhi (
floatorSeriesortupleoffloatorSeries) – Diffuse horizontal irradiance. [W/m2]dni_extra (
None,float,SeriesortupleoffloatorSeries, default None) – Extraterrestrial direct normal irradiance. [W/m2]airmass (
None,floatorSeries, defaultNone) – Airmass. [unitless]albedo (
None,floatorSeries, defaultNone) – 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 (
DataFrameortupleofDataFrame) – Column names are:'poa_global', 'poa_direct', 'poa_diffuse', 'poa_sky_diffuse', 'poa_ground_diffuse'.