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. [Wm⁻²]
aoi (array-like) – Angle of incidence of solar rays with respect to the module surface normal.
solar_zenith (array-like) – True (not refraction-corrected) solar zenith angles in decimal degrees.
solar_azimuth (array-like) – Solar azimuth angles in decimal degrees.
times (DatetimeIndex) – Time indices for the input array-like data.
surface_tilt (numeric) – Surface tilt angles in decimal degrees. Tilt must be >=0 and <=180. The tilt angle is defined as degrees from horizontal (e.g. surface facing up = 0, surface facing horizon = 90).
surface_azimuth (numeric) – Surface azimuth angles in decimal degrees. surface_azimuth must be >=0 and <=360. The Azimuth convention is defined as degrees east of north (e.g. North = 0, South=180 East = 90, West = 270).
pressure (numeric, default 101325.0) – The site pressure in Pascal. Pressure may be measured or an average pressure may be calculated from site altitude.
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 temperatures, in degrees C. 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.
albedo (numeric, default 0.25) – Ground surface 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 in Wm⁻².
References
Examples using pvlib.irradiance.gti_dirint#
Reverse transposition using one year of hourly data