Skip to content

Add aod and clearsky_index to glossary, link terms in spectrum.rst #2663

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
RDaxini wants to merge 12 commits into
base: main
Choose a base branch
from
+51 −23
Open

Add aod and clearsky_index to glossary, link terms in spectrum.rst #2663

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
eae7536
add aod, clearsky index
RDaxini Jan 21, 2026
83089aa
line length of various definitions
RDaxini Jan 21, 2026
ff24b9e
Update spectrum.rst
RDaxini Jan 21, 2026
296831e
add clarification for numbers eg aod500
RDaxini Jan 21, 2026
62e1a9b
link aod500 in spectrum.rst
RDaxini Jan 21, 2026
950d928
Merge remote-tracking branch 'upstream/main' into glossary_definitions
RDaxini Feb 6, 2026
baf4fe6
Apply suggestions from code review
RDaxini Feb 6, 2026
5f7ace9
Merge branch 'glossary_definitions' of https://github.com/RDaxini/pvl…
RDaxini Feb 6, 2026
07244de
rearrange [unitless]
RDaxini Feb 6, 2026
cfeadf6
add clearness_index
RDaxini Feb 6, 2026
8e6d44f
Update v0.15.1.rst
RDaxini Feb 6, 2026
143af0d
Update v0.15.1.rst
RDaxini Feb 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 42 additions & 20 deletions docs/sphinx/source/user_guide/extras/nomenclature.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,16 @@ There is a convention on consistent variable names throughout the library:
albedo
Ratio of reflected solar irradiance to global horizontal irradiance
[unitless]


aod
aod500
aerosol optical depth [unitless]. Measure of aerosols (e.g., smoke
particles, desert dust) distributed within a column of air from the
instrument (Earth's surface) to the top of the atmosphere. The AOD
value indicates the level of extinction of sunlight in this column, and
when followed by a number (e.g. AOD500), indicates the extinction at
this wavelength (500nm).

Comment on lines 23 to 31
Copy link
Member

@echedey-ls echedey-ls Jan 21, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it described by these equations? https://en.wikipedia.org/wiki/Optical_depth#Spectral_optical_depth

I have trouble finding PV specific information on a mathematical relationship. At least that is the only missing piece for me.

aoi
Angle of incidence. Angle between the surface normal vector and the
vector pointing towards the sun's center. [°]
Expand All @@ -33,17 +42,26 @@ There is a convention on consistent variable names throughout the library:

apparent_zenith
Refraction-corrected solar zenith angle. The solar
zenith angle describes the position of the sun relative to the vertical and is
defined as the angle between a vector pointed straight up and a vector pointed
at the sun, from the observer. [°]
zenith angle describes the position of the sun relative to the vertical
and is defined as the angle between a vector pointed straight up and a
vector pointed at the sun, from the observer. [°]

apparent_elevation
Refraction-corrected solar elevation angle. This is the complement of
:term:`apparent_zenith` (90 - apparent_zenith). [°]

bhi
Beam/direct horizontal irradiance


clearness_index
clearness index [unitless]. Ratio of global horizontal irraidance to
the extra terrestrial irriance. The clearness index ranges between
0 and 1, with values closer to 1 indicating clear skies.

clearsky_index
clearsky index [unitless]. Ratio of actual global irradiance to modeled
clearsky global irradiance.

dhi
Diffuse horizontal irradiance

Expand Down Expand Up @@ -95,10 +113,12 @@ There is a convention on consistent variable names throughout the library:
Sandia Array Performance Model IV curve parameters

latitude
Latitude in decimal degrees. Positive north of equator, negative to south.
Latitude in decimal degrees. Positive north of equator, negative to
south.

longitude
Longitude in decimal degrees. Positive east of prime meridian, negative to west.
Longitude in decimal degrees. Positive east of prime meridian, negative
to west.

pac, ac
AC power
Expand Down Expand Up @@ -149,15 +169,16 @@ There is a convention on consistent variable names throughout the library:
Diode saturation current

solar_azimuth
Azimuth angle of the sun in degrees East of North. The solar azimuth angle
describes the sun’s position along the horizon relative to the observer.
The pvlib-python convention is defined as degrees East of North, so
North = 0°, East = 90°, South = 180°, West = 270°.
Azimuth angle of the sun in degrees East of North. The solar azimuth
angle describes the sun’s position along the horizon relative to the
observer. Azimuth is defined as degrees East of
North, so North = 0°, East = 90°, South = 180°, West = 270°.

solar_zenith
Zenith angle of the sun in degrees. This is the angle between is between a
vector pointed straight up and a vector pointed at the sun, from the observer.
This is the complement of solar elevation (90 - elevation). [°]
Zenith angle of the sun in degrees [°]. Zenith is the angle between is
between a vector pointed straight up and a vector pointed at the sun,
from the observer. Zenith is the complement of solar elevation, i.e.,
zenith = 90 - elevation.

spectra
spectra_components
Expand All @@ -167,16 +188,17 @@ There is a convention on consistent variable names throughout the library:
is composed of direct and diffuse components.

surface_azimuth
Azimuth angle of the surface in degrees East of North. This angle describes the
horizontal projection of the normal vector from the surface. The pvlib-python
convention is defined as degrees East (clockwise) of North, so North = 0°,
East = 90°, South = 180°, West = 270°.
Azimuth angle of the surface in degrees East of North. Surface azimuth
is specified by the horizontal projection of the normal vector from
the surface. Azimuth is defined as degrees East
(clockwise) of North, so North = 0°, East = 90°, South = 180°,
West = 270°.

surface_tilt
Tilt from horizontal [°]. The surface tilt angle
is defined as degrees from the horizontal
such that a surface facing up would have a surface tilt of 0°, and one facing
the horizon would be 90°. [°]
such that a surface facing up would have a surface tilt of 0°, and one
facing the horizon would be 90°. [°]

temp_air
Temperature of the air
Expand Down
6 changes: 3 additions & 3 deletions docs/sphinx/source/user_guide/modeling_topics/spectrum.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,21 +51,21 @@ Reference [2]_.
| +-----------------------------+ | | | | | | |
| |:term:`precipitable_water`, | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | [2]_ |
| +-----------------------------+ | | | | | | |
| | aod | | | | | | | |
| | :term:`aod` | | | | | | | |
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
| :py:func:`First Solar <spectral_factor_firstsolar>` | :term:`airmass_absolute`, | | | | | | | |
| +-----------------------------+ | ✓ | ✓ | | | | [3]_ |
| | :term:`precipitable_water` | | | | | | | |
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
| :py:func:`JRC <spectral_factor_jrc>` | :term:`airmass_relative`, | | | | | | | |
| +-----------------------------+ | ✓ | ✓ | | | + [4]_ |
| | clearsky_index | | | | | | | |
| | :term:`clearsky_index` | | | | | | | |
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
| :py:func:`Polo <spectral_factor_polo>` | :term:`precipitable_water`, | | | | | | | |
| +-----------------------------+ ✓ | | ✓ | ✓ | ✓ | + [5]_ |
| | :term:`airmass_absolute`, | | | | | | | |
| +-----------------------------+ | | | | | | |
| | aod500, | | | | | | | |
| | :term:`aod500` | | | | | | | |
| +-----------------------------+ | | | | | | |
| | :term:`aoi`, | | | | | | | |
| +-----------------------------+ | | | | | | |
Expand Down
6 changes: 6 additions & 0 deletions docs/sphinx/source/whatsnew/v0.15.1.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ Enhancements

Documentation
~~~~~~~~~~~~~
* Add the following terms to the :ref:`nomenclature` page:
- :term:`clearness_index`
- :term:`clearsky_index`
- :term:`aod`
- :term:`aod500`
(:issue:`2564`, :pull:`2663`)


Testing
Expand Down