Skip to content
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.

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

add spectra and spectra_components to nomenclature page #2264

Merged
merged 16 commits into from
Nov 5, 2024
Merged
7 changes: 7 additions & 0 deletions docs/sphinx/source/user_guide/nomenclature.rst
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,13 @@ 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 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

Expand Down
3 changes: 3 additions & 0 deletions docs/sphinx/source/whatsnew/v0.11.2.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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`)
kandersolar marked this conversation as resolved.
Show resolved Hide resolved
* 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
Expand All @@ -34,6 +36,7 @@ Documentation
* Explained how to write docstrings for new functions in :ref:`example-docstring`
(:discussion:`2081`, :pull:`2254`)


Testing
~~~~~~~

Expand Down
3 changes: 2 additions & 1 deletion pvlib/spectrum/irradiance.py
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

A single spectrum must be a :py:class:`pandas.Series` with wavelength
[nm] as the index, while multiple spectra must be rows in a
Expand Down
3 changes: 2 additions & 1 deletion pvlib/spectrum/spectrl2.py
Original file line number Diff line number Diff line change
Expand Up @@ -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`.

* wavelength
* dni_extra
Expand Down
Loading