pvlib.irradiance.gti_dirint#

pvlib.irradiance.gti_dirint(poa_global, aoi, solar_zenith, solar_azimuth, times, surface_tilt, surface_azimuth, pressure=101325.0, use_delta_kt_prime=True, temp_dew=None, albedo=0.25, model='perez', model_perez='allsitescomposite1990', calculate_gt_90=True, max_iterations=30)[source]#

Determine GHI, DNI, DHI from POA global using the GTI DIRINT model.

The GTI DIRINT model is described in [1].

Warning

Model performance is poor for AOI greater than approximately 80 degrees and plane of array irradiance greater than approximately 200 Wm⁻².

Parameters:

  • poa_global (array-like) – Plane of array global irradiance. See poa_global. [Wm⁻²]

  • aoi (array-like) – Angle of incidence of solar rays with respect to the module surface normal. See aoi. [°]

  • solar_zenith (array-like) – True (not refraction-corrected) solar zenith angles in decimal degrees. See solar_zenith. [°]

  • solar_azimuth (array-like) – Solar azimuth angles. See solar_azimuth. [°]

  • times (DatetimeIndex) – Time indices for the input array-like data.

  • surface_tilt (numeric) – Surface tilt angle, see surface_tilt. [°]

  • surface_azimuth (numeric) – Surface azimuth angles, see surface_azimuth. [°]

  • pressure (numeric, default 101325.0) – Site air pressure. See pressure. [Pa]

  • use_delta_kt_prime (bool, default True) – If True, indicates that the stability index delta_kt_prime is included in the model. The stability index adjusts the estimated DNI in response to dynamics in the time series of GHI. It is recommended that delta_kt_prime is not used if the time between GHI points is 1.5 hours or greater. If use_delta_kt_prime=True, input data must be Series.

  • temp_dew (float, or array-like, optional) – Surface dew point temperature. Values of temp_dew may be numeric or NaN. Any single time period point with a temp_dew=NaN does not have dew point improvements applied. If temp_dew is not provided, then dew point improvements are not applied. See temp_dew. [°C]

  • albedo (numeric, default 0.25) – Ground surface albedo. See albedo. [unitless]

  • model (String, default 'perez') – Irradiance model. See get_sky_diffuse() for allowed values.

  • model_perez (String, default 'allsitescomposite1990') – Used only if model=’perez’. See perez().

  • calculate_gt_90 (bool, default True) – Controls if the algorithm evaluates inputs with AOI >= 90 degrees. If False, returns nan for AOI >= 90 degrees. Significant speed ups can be achieved by setting this parameter to False.

  • max_iterations (int, default 30) – Maximum number of iterations for the aoi < 90 deg algorithm.

Returns:

data (DataFrame) – Contains the following keys/columns:

  • ghi: the modeled global horizontal irradiance. [Wm⁻²]

  • dni: the modeled direct normal irradiance. [Wm⁻²]

  • dhi: the modeled diffuse horizontal irradiance. [Wm⁻²]

References

Examples using pvlib.irradiance.gti_dirint#

Reverse transposition using one year of hourly data

Reverse transposition using one year of hourly data
On this page
View on GitHub