Documentation Index
Fetch the complete documentation index at: https://docs.plantpredict.com/llms.txt
Use this file to discover all available pages before exploring further.
Summary
The Perez transposition model estimates sky diffuse irradiance on a tilted surface by decomposing into three components: background, brightening near the solar disk, and near the horizon band. It uses empirical coefficients derived from extensive sky radiance measurements. Sky clearness and brightness indices determine which coefficient set is applied. PlantPredict supports multiple Perez coefficient sets derived from different locations and time periods.
| Name | Symbol | Units | Description |
|---|
| Global Horizontal Irradiance | GHI | W/m² | Total irradiance on horizontal surface |
| Direct Normal Irradiance | DNI | W/m² | Direct beam irradiance perpendicular to sun |
| Diffuse Horizontal Irradiance | DHI | W/m² | Diffuse irradiance on horizontal surface |
| Extraterrestrial Direct Normal Irradiance | DNIextra | W/m² | Direct normal irradiance at top of atmosphere |
| Solar Zenith Angle | θz | degrees | Angle between sun and local vertical |
| Angle of Incidence | θAOI | degrees | Angle between sun and surface normal |
| Surface Tilt Angle | βm | degrees | Tilt angle of surface from horizontal |
| Albedo | ρ | — | Ground reflectance (0–1) |
| Air Mass | AM | — | Air mass (see Air Mass) |
Outputs
| Name | Symbol | Units | Description |
|---|
| POA Beam | Gbeam | W/m² | Direct beam irradiance on tilted surface |
| POA Sky Diffuse | Gsky | W/m² | Sky diffuse irradiance on tilted surface |
| POA Ground Diffuse | Gground | W/m² | Ground-reflected irradiance on tilted surface |
Detailed Description
Sky Clearness and Brightness Indices
The Perez model uses two atmospheric parameters to characterize sky conditions:
Sky Clearness Index (ε): Represents the clarity of the atmosphere, accounting for the ratio of total to diffuse horizontal irradiance and solar zenith angle:
ε=1+κθz3DHIDHI+DNI+κθz3
where κ=5.535×10−6 is an empirical constant that corrects the clearness index for zenith angle dependence.
Sky Brightness Index (Δ): Represents the amount of diffuse irradiance relative to extraterrestrial irradiance, normalized by :
Δ=DNIextraDHI⋅AM
where AM is the (non pressure-corrected) air mass calculated using the configured air mass model.
Perez Coefficient Lookup
The clearness index ε is binned into 8 categories corresponding to sky conditions from overcast to clear. Each bin has associated empirical coefficients used to compute brightness coefficients F1 and F2:
| Bin | ε Range | Sky Condition |
|---|
| 1 | [1.000, 1.065) | Overcast |
| 2 | [1.065, 1.230) | Overcast |
| 3 | [1.230, 1.500) | Partly Cloudy |
| 4 | [1.500, 1.950) | Partly Cloudy |
| 5 | [1.950, 2.800) | Partly Cloudy |
| 6 | [2.800, 4.500) | Clear |
| 7 | [4.500, 6.200) | Clear |
| 8 | [6.200, ∞) | Clear |
For each bin, coefficients f11,f12,f13,f21,f22,f23—from which the Brightness Coefficients F1 and F2 are computed—are defined. PlantPredict supports multiple coefficient sets, each tailored to specific climatic conditions and derived from empirical measurements:
Composite Coefficient Sets:
- PlantPredict: Default coefficient set, matches the All Sites Composite 1990 set to the third digit
- All Sites Composite 1990: Comprehensive set derived from data across multiple locations using 1990 methodology.
- All Sites Composite 1988: Earlier composite set based on 1988 methodology from various sites.
- Sandia Composite 1988: Developed using data from Sandia National Laboratories.
- USA Composite 1988: Based on data collected from various U.S. locations.
Location-Specific Coefficient Sets (1988):
- France 1988: Derived from data collected in France.
- Phoenix 1988: Derived from data collected in Phoenix, Arizona.
- El Monte 1988: Derived from data collected in El Monte, California.
- Osage 1988: Derived from data collected in Osage, Iowa.
- Albuquerque 1988: Derived from data collected in Albuquerque, New Mexico.
- Cape Canaveral 1988: Derived from data collected in Cape Canaveral, Florida.
- Albany 1988: Derived from data collected in Albany, New York.
The selection of coefficient set can influence model accuracy depending on site-specific climatic conditions. Composite sets provide general applicability, while location-specific sets may offer improved accuracy for sites with similar climate characteristics. The complete coefficient values for all sets can be found in the pvlib documentation.
Brightness Coefficients
The brightness coefficients F1 and F2 are computed using the binned coefficients:
F1=f11+f12Δ+f13⋅180πθz
F2=f21+f22Δ+f23⋅180πθz
A quality control constraint is applied: F1≥0. Physically, F1 quantifies circumsolar brightening (which cannot be negative), while F2 quantifies horizon brightening or darkening (can be negative under clear sky conditions).
Diffuse Irradiance Components
DHI is then decomposed into three components (isotropic sky, circumsolar, and horizon) using F1 and F2.
Isotropic Component: Uniform diffuse irradiance from the sky dome, reduced by the circumsolar fraction F1:
Gisotropic=DHI⋅(1−F1)⋅21+cos(βm)
The term (1+cos(βm))/2 is the from the tilted surface to the sky dome.
Circumsolar Component: Directional diffuse irradiance concentrated near the solar disk:
Gcircumsolar=DHI⋅F1⋅cos(θz)cos(θAOI)
The ratio cos(θAOI)/cos(θz) is the projection ratio that converts horizontal circumsolar irradiance to the tilted plane, identical to the Hay-Davies model. When the sun is behind the module (cos(θAOI)<0), the circumsolar component is set to zero. To avoid numerical instabilities near the horizon, a minimum threshold is applied: cos(θz)≥0.0872 (corresponding to θz≤85°).
Horizon Component: Diffuse irradiance from the horizon band:
Ghorizon=DHI⋅F2⋅sin(βm)
The horizon component can be negative when F2<0, which can occur under clear sky conditions when the horizon band is darker than the average sky dome (horizon darkening effect).
Circumsolar Allocation
The circumsolar component can be allocated to beam or diffuse POA irradiance (default: Diffuse), similar to the Hay-Davies model:
Direct Allocation:
Gsky=Gisotropic+Ghorizon
Gbeam=DNI⋅cos(θAOI)+Gcircumsolar
Diffuse Allocation:
Gsky=Gisotropic+Gcircumsolar+Ghorizon
Gbeam=DNI⋅cos(θAOI)
Circumsolar irradiance originates from near the solar disk and is blocked by obstructions the same way direct beam is. Allocating it to beam ensures that row-to-row shading calculations apply appropriate losses to circumsolar. Allocating to diffuse treats circumsolar as unaffected by direct shading, which may be appropriate for unshaded systems or when shading is negligible.
Ground-Reflected Component
The ground-reflected component accounts for irradiance reflected from the ground onto the tilted surface:
Gground=ρ⋅GHI⋅21−cos(βm)
The term (1−cos(βm))/2 is the view factor from the tilted surface to the ground.
Quality Control
Physical constraints are enforced by clamping values:
- If F1<0 → F1=0
- If Gisotropic<0 → Gisotropic=0
- If Gcircumsolar<0 → Gcircumsolar=0
- If Gsky>800 W/m² → Gsky=800 W/m²
The horizon component Ghorizon is not clamped and may be negative.
References
- Perez, R., Seals, R., Ineichen, P., Stewart, R., & Menicucci, D. (1987). A new simplified version of the Perez diffuse irradiance model for tilted surfaces. Solar Energy, 39(3), 221–231. DOI: 10.1016/S0038-092X(87)80031-2
- Perez, R., Ineichen, P., Seals, R., Michalsky, J., & Stewart, R. (1990). Modeling daylight availability and irradiance components from direct and global irradiance. Solar Energy, 44(5), 271–289. DOI: 10.1016/0038-092X(90)90055-H
- pvlib python. Irradiance module source code. https://pvlib-python.readthedocs.io/en/latest/_modules/pvlib/irradiance.html