diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index 9b0b92cbda..bd6440a47c 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -51,7 +51,7 @@ Reference [2]_. | +-----------------------------+ | | | | | | | | |:term:`precipitable_water`, | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | [2]_ | | +-----------------------------+ | | | | | | | -| | :term:`aod` | | | | | | | | +| | aod | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`First Solar ` | :term:`airmass_absolute`, | | | | | | | | | +-----------------------------+ | ✓ | ✓ | | | | [3]_ | @@ -59,11 +59,11 @@ Reference [2]_. +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`JRC ` | :term:`airmass_relative`, | | | | | | | | | +-----------------------------+ | ✓ | ✓ | | | + [4]_ | -| | :term:`clearsky_index` | | | | | | | | +| | clearsky_index | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`PVSPEC ` | :term:`airmass_absolute`, | | | | | | | | | +-----------------------------+ ✓ | ✓ | ✓ | ✓ | ✓ | | [5]_ | -| | :term:`clearsky_index` | | | | | | | | +| | clearsky_index | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`SAPM ` | :term:`airmass_absolute` | | | | | | | [6]_ | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ diff --git a/docs/sphinx/source/whatsnew/v0.13.1.rst b/docs/sphinx/source/whatsnew/v0.13.1.rst index 635ce469c7..00e117b86b 100644 --- a/docs/sphinx/source/whatsnew/v0.13.1.rst +++ b/docs/sphinx/source/whatsnew/v0.13.1.rst @@ -1,17 +1,13 @@ .. _whatsnew_0_13_1: -v0.13.1 (Anticipated September, 2025) +v0.13.1 (September 24, 2025) ------------------------------------- -Breaking Changes -~~~~~~~~~~~~~~~~ - - Deprecations ~~~~~~~~~~~~ -* Deprecate :py:func:`~pvlib.modelchain.get_orientation`. (:pull:`2495`) -* Rename parameter name ``aparent_azimuth`` to ``solar_azimuth`` in :py:func:`~pvlib.tracking.singleaxis`. +* Deprecate :py:func:`pvlib.modelchain.get_orientation`. (:pull:`2495`) +* Rename parameter name ``apparent_azimuth`` to ``solar_azimuth`` in :py:func:`~pvlib.tracking.singleaxis`. (:issue:`2479`, :pull:`2480`) Bug fixes @@ -21,8 +17,9 @@ Bug fixes Enhancements ~~~~~~~~~~~~ -* Add new parameters for the Huld PV array mode :py:func:`~pvlib.pvarray.huld` (:issue:`2461`, :pull:`2486`) -* Add k coefficient in :py:func:`~pvlib.temperature.ross` +* Add option to use the latest parameters for the Huld PV array model + :py:func:`~pvlib.pvarray.huld`. (:issue:`2461`, :pull:`2486`) +* Add option to specify ``k`` coefficient in :py:func:`~pvlib.temperature.ross`. (:issue:`2506`, :pull:`2521`) * Add iotools functions to retrieve irradiance and weather data from Meteonorm: :py:func:`~pvlib.iotools.get_meteonorm_forecast_basic`, :py:func:`~pvlib.iotools.get_meteonorm_forecast_precision`, @@ -33,8 +30,8 @@ Enhancements (:pull:`2500`) * :py:func:`pvlib.spectrum.spectral_factor_firstsolar` no longer emits warnings when airmass and precipitable water values fall out of range. (:pull:`2512`) -* Allows reading TMY data from a Path or file-like object in :py:func:`~pvlib.iotools.read_tmy3`. - (:pull:`2544`, :ghuser:`jerluc`) +* Allow reading TMY data from a Path or file-like object in :py:func:`~pvlib.iotools.read_tmy3`. + (:pull:`2544`) Documentation ~~~~~~~~~~~~~ @@ -44,19 +41,11 @@ Documentation and other miscellaneous edits. (:issue:`2205`, :issue:`2248`, :pull:`2311`) * Substantiate definitions of solar/surface azimuth/zenith and aoi on the :ref:`nomenclature` page. (:issue:`2448`, :pull:`2503`) -* Add a new reference page for the spectrum (:ref:`_spectrum_user_guide`) to the +* Add a new reference page for the spectrum (:ref:`spectrum_user_guide`) to the Modeling Topics section of the user guide, documenting pvlib-python's spectrum functionality, which includes a comparison table of spectral mismatch estimation models. (:issue:`2329`, :pull:`2353`) - - -Testing -~~~~~~~ - - -Benchmarking -~~~~~~~~~~~~ - +* Fix FAQ URL in ``README.md``. (:pull:`2488`) Requirements ~~~~~~~~~~~~ @@ -65,22 +54,26 @@ Requirements * Advance minimum scipy to 1.7.2. (:pull:`2547`) * Advance minimum pandas to 1.3.3. (:pull:`2547`) - Maintenance ~~~~~~~~~~~ -* Fix FAQ URL in ``README.md``. (:pull:`2488`) - +* Switch to using Trusted Publishing for deploying releases to PyPI. (:issue:`2511`, :pull:`2549`) Contributors ~~~~~~~~~~~~ * Elijah Passmore (:ghuser:`eljpsm`) * Omar Bahamida (:ghuser:`OmarBahamida`) * Cliff Hansen (:ghuser:`cwhanse`) - * Ioannis Sifnaios (:ghuser:`IoannisSifnaios`) * Rajiv Daxini (:ghuser:`RDaxini`) -* Omar Bahamida (:ghuser:`OmarBahamida`) * Rodrigo Amaro e Silva (:ghuser:`ramaroesilva`) * Kevin Anderson (:ghuser:`kandersolar`) * Mikaella Brewer (:ghuser:`brwerx`) * Will Holmgren (:ghuser:`wholmgren`) +* Jeremy Lucas (:ghuser:`jerluc`) +* Adam R. Jensen (:ghuser:`AdamRJensen`) +* Will Hobbs (:ghuser:`williamhobbs`) +* Echedey Luis (:ghuser:`echedey-ls`) +* Anton Driesse (:ghuser:`adriesse`) +* Mark Mikofski (:ghuser:`mikofski`) +* Mathias Aschwanden (:ghuser:`maschwanden`) +* :ghuser:`leopardracer` diff --git a/pvlib/irradiance.py b/pvlib/irradiance.py index c932866bbb..5a9051614b 100644 --- a/pvlib/irradiance.py +++ b/pvlib/irradiance.py @@ -501,8 +501,8 @@ def poa_components(aoi, dni, poa_sky_diffuse, poa_ground_diffuse): * ``poa_direct`` : Total in-plane beam irradiance. [Wm⁻²] * ``poa_diffuse`` : Total in-plane diffuse irradiance. [Wm⁻²] * ``poa_sky_diffuse`` : In-plane diffuse irradiance from sky. [Wm⁻²] - * ``poa_ground_diffuse`` : In-plane diffuse irradiance from ground - . [Wm⁻²] + * ``poa_ground_diffuse`` : In-plane diffuse irradiance from ground. + [Wm⁻²] Notes ------ @@ -997,11 +997,11 @@ def king(surface_tilt, dhi, ghi, solar_zenith): Parameters ---------- - surface_tilt : numeric - Panel tilt from the horizontal. See :term:`surface_tilt`. [°] + surface_tilt : numeric + Panel tilt from the horizontal. See :term:`surface_tilt`. [°] - dhi : numeric - Diffuse horizontal irradiance. See :term:`dhi`. [Wm⁻²] + dhi : numeric + Diffuse horizontal irradiance. See :term:`dhi`. [Wm⁻²] ghi : numeric Global horizontal irradiance. See :term:`ghi`. [Wm⁻²] @@ -1729,7 +1729,7 @@ def clearness_index_zenith_independent(clearness_index, airmass, plane. [unitless] airmass : numeric - Airmass. See :term:`relative_airmass`. [unitless] + Airmass. See :term:`airmass_relative`. [unitless] max_clearness_index : numeric, default 2.0 Maximum value of the clearness index. The default, 2.0, allows