add spectra and spectra_components to nomenclature page

docs/sphinx/source/user_guide/nomenclature.rst

@@ -142,6 +142,12 @@ There is a convention on consistent variable names throughout the library:
     solar_zenith
         Zenith angle of the sun in degrees
 
+    spectra, spectra_components
+        Spectral irradiance (components) [Wm⁻²nm⁻¹]. The amount of energy
+        incident on a horizontal unit area per unit time and per unit
+        wavelength. As with broadband irradiance, global spectral irradiance
+        is composed of direct and diffuse components.
+
     surface_azimuth
         Azimuth angle of the surface
 

docs/sphinx/source/whatsnew/v0.11.2.rst

@@ -25,6 +25,8 @@ Documentation
 ~~~~~~~~~~~~~
 * Edited docstrings for :py:func:`~pvlib.pvsystem.dc_ohms_from_percent` and
   :py:func:`~pvlib.pvsystem.dc_ohmic_losses` for clarity. (:issue:`1601`, :pull:`2229`)
+* Added variables `spectra` and `spectra_components` to the
+  :ref:`nomenclature` page. (:issue:`2150`, :pull:`2264`)
 * Added a new citation style guide (:ref:`references`) to the contributing
   page. (:issue:`2202`, :pull:`2226`)
 * Updated :py:func:`~pvlib.irradiance.reindl` to include definitions of terms
@@ -34,6 +36,7 @@ Documentation
 * Explained how to write docstrings for new functions in :ref:`example-docstring`
   (:discussion:`2081`, :pull:`2254`)
 
+
 Testing
 ~~~~~~~
 

pvlib/spectrum/irradiance.py

@@ -189,7 +189,8 @@ def average_photon_energy(spectra):
     ----------
     spectra : pandas.Series or pandas.DataFrame
 
-        Spectral irradiance, must be positive. [Wm⁻²nm⁻¹]
+        Spectral irradiance, must be positive [Wm⁻²nm⁻¹].
+        See :term:`spectra <spectra, spectra_components>`.
 
         A single spectrum must be a :py:class:`pandas.Series` with wavelength
         [nm] as the index, while multiple spectra must be rows in a

pvlib/spectrum/spectrl2.py

@@ -228,10 +228,11 @@ def spectrl2(apparent_zenith, aoi, surface_tilt, ground_albedo,
     Returns
     -------
     spectra_components : dict
-        A dict of arrays.  With the exception of `wavelength`, which has length
+        A dict of arrays. With the exception of `wavelength`, which has length
         122, each array has shape (122, N) where N is the length of the
         input ``apparent_zenith``.  All values are spectral irradiance
         with units Wm⁻²nm⁻¹, except for `wavelength`, which is in nanometers.
+        See :term:`spectra_components <spectra, spectra_components>`.
 
         * wavelength
         * dni_extra