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 Model calculates the relative optical path length of sunlight through earth’s atmosphere based on the solar , accounting for atmospheric and curvature effects. PlantPredict implements two empirical air mass models: Bird-Hulstrom and Kasten-Sandia. Air mass is used downstream in models (Perez), models (DIRINT), and calculations.
| Name | Symbol | Units | Description |
|---|
| Solar Zenith Angle | θz | degrees | Angle between the zenith and the line of sight to the sun |
| Atmospheric Pressure | P | hPa | Local atmospheric pressure |
| Altitude | h | m | Elevation above sea level |
Outputs
| Name | Symbol | Units | Description |
|---|
| Relative Air Mass | AM | — | Optical path length relative to zenith; used in Perez transposition |
| Pressure-Corrected Air Mass | AM′ | — | Air mass adjusted for local pressure; used in DIRINT decomposition and spectral shift |
Detailed Description
The Air Mass Model quantifies how much longer the path through the atmosphere is compared to the vertical path at zenith. At zenith (θz=0°), air mass equals 1.0. As the sun approaches the horizon, the path length increases. PlantPredict provides two empirical models that account for atmospheric curvature and refraction:
- Bird-Hulstrom: Based on Bird & Hulstrom (1981)
- Kasten-Sandia: Based on Kasten & Young (1989)
Both models use the same general formula but with different empirical coefficients derived from atmospheric observations:
AM=cos(θz)+a(b−θz)−c1
| Model | a | b | c |
|---|
| Bird-Hulstrom | 0.15 | 93.885 | 1.253 |
| Kasten-Sandia | 0.50572 | 96.07995 | 1.6364 |
For zenith angles at or above 89°, air mass is set to zero:
AM=0for θz≥89°
At these grazing angles the empirical formula becomes unreliable; however, incident solar radiation is also negligible, so the cutoff minimally affects energy calculations.
Typical air mass values:
- At sea level, zenith: AM=1.0
- At sea level, θz=60°: AM≈2.0
- At sea level, θz=80°: AM≈5.7
- At sea level, θz=85°: AM≈11−12
Pressure Correction
For spectral calculations, PlantPredict uses the pressure-corrected air mass AM′. This accounts for the fact that atmospheric scattering and absorption scale with air density—at lower pressures (e.g., higher elevations), there are fewer molecules to scatter and absorb radiation, reducing these effects:
AM′=AM×P0P
where:
- AM is the relative air mass from above
- P is the local atmospheric pressure (hPa)
- P0=1013.25 hPa is standard sea level pressure
Pressure from Altitude
If pressure is not directly provided in the weather file, PlantPredict estimates it from elevation using the barometric formula:
P=1013.25×(1−h×2.25577×10−5)5.25588
where h is elevation in meters above sea level.
This formula is based on the standard atmosphere model, which assumes a temperature decrease rate of 6.5°C per kilometer of altitude.
References
- Kasten, F., & Young, A. T. (1989). Revised optical air mass tables and approximation formula. Applied Optics, 28(22), 4735–4738. DOI: 10.1364/AO.28.004735
- Bird, R. E., & Hulstrom, R. L. (1981). A simplified clear sky model for direct and diffuse insolation on horizontal surfaces. Solar Energy Research Institute Report SERI/TR-642-761. DOI: 10.2172/6510849