pvlib.atmosphere.get_relative_airmass#

pvlib.atmosphere.get_relative_airmass(zenith, model='kastenyoung1989')[source]#

Calculate relative (not pressure-adjusted) airmass at sea level.

Parameter model allows selection of different airmass models.

Parameters

  • zenith (numeric) – Zenith angle of the sun. [degrees]

  • model (string, default 'kastenyoung1989') –

    Available models include the following:

    • ’simple’ - secant(apparent zenith angle) - Note that this gives -Inf at zenith=90

    • ’kasten1966’ - See reference [1] - requires apparent sun zenith

    • ’youngirvine1967’ - See reference [2] - requires true sun zenith

    • ’kastenyoung1989’ (default) - See reference [3] - requires apparent sun zenith

    • ’gueymard1993’ - See reference [4] - requires apparent sun zenith

    • ’young1994’ - See reference [5] - requires true sun zenith

    • ’pickering2002’ - See reference [6] - requires apparent sun zenith

    • ’gueymard2003’ - See references [7] and [8] - requires apparent sun zenith

Returns

airmass_relative (numeric) – Relative airmass at sea level. Returns NaN values for any zenith angle greater than 90 degrees. [unitless]

Notes

Some models use apparent (refraction-adjusted) zenith angle while other models use true (not refraction-adjusted) zenith angle. Apparent zenith angles should be calculated at sea level.

References

1

Fritz Kasten. “A New Table and Approximation Formula for the Relative Optical Air Mass”. Technical Report 136, Hanover, N.H.: U.S. Army Material Command, CRREL.

2

A. T. Young and W. M. Irvine, “Multicolor Photoelectric Photometry of the Brighter Planets,” The Astronomical Journal, vol. 72, pp. 945-950, 1967.

3

Fritz Kasten and Andrew Young. “Revised optical air mass tables and approximation formula”. Applied Optics 28:4735-4738

4

C. Gueymard, “Critical analysis and performance assessment of clear sky solar irradiance models using theoretical and measured data,” Solar Energy, vol. 51, pp. 121-138, 1993.

5

A. T. Young, “AIR-MASS AND REFRACTION,” Applied Optics, vol. 33, pp. 1108-1110, Feb 1994.

6

Keith A. Pickering. “The Ancient Star Catalog”. DIO 12:1, 20,

7

C. Gueymard, “Direct solar transmittance and irradiance predictions with broadband models. Part I: detailed theoretical performance assessment”. Solar Energy, vol 74, pp. 355-379, 2003. DOI: 10.1016/S0038-092X(03)00195-6

8

C. Gueymard (2019). Clear-Sky Radiation Models and Aerosol Effects. In: Polo, J., Martín-Pomares, L., Sanfilippo, A. (eds) Solar Resources Mapping. Green Energy and Technology. Springer, Cham. DOI: 10.1007/978-3-319-97484-2_5

9

Matthew J. Reno, Clifford W. Hansen and Joshua S. Stein, “Global Horizontal Irradiance Clear Sky Models: Implementation and Analysis” Sandia Report, (2012).

Examples using pvlib.atmosphere.get_relative_airmass#

Modeling Spectral Irradiance

Modeling Spectral Irradiance

previous

pvlib.atmosphere.get_absolute_airmass

next

pvlib.atmosphere.pres2alt