From f82d273d033ea7890a2d030d5fa3fd3871c60735 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Wed, 24 Sep 2025 09:31:19 -0400 Subject: [PATCH 1/6] fix up whatsnew formatting --- docs/sphinx/source/whatsnew/v0.13.1.rst | 30 +++++++------------------ 1 file changed, 8 insertions(+), 22 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.13.1.rst b/docs/sphinx/source/whatsnew/v0.13.1.rst index 635ce469c7..fd6136fbdc 100644 --- a/docs/sphinx/source/whatsnew/v0.13.1.rst +++ b/docs/sphinx/source/whatsnew/v0.13.1.rst @@ -4,10 +4,6 @@ v0.13.1 (Anticipated September, 2025) ------------------------------------- -Breaking Changes -~~~~~~~~~~~~~~~~ - - Deprecations ~~~~~~~~~~~~ * Deprecate :py:func:`~pvlib.modelchain.get_orientation`. (:pull:`2495`) @@ -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 ~~~~~~~~~~~~~ @@ -48,15 +45,7 @@ Documentation 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,19 @@ 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`) From 7025311bbb87f1bbd1267e8695fb5522da49b42b Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Wed, 24 Sep 2025 09:36:33 -0400 Subject: [PATCH 2/6] add missing contributors for 0.13.1 --- docs/sphinx/source/whatsnew/v0.13.1.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/sphinx/source/whatsnew/v0.13.1.rst b/docs/sphinx/source/whatsnew/v0.13.1.rst index fd6136fbdc..28582870dd 100644 --- a/docs/sphinx/source/whatsnew/v0.13.1.rst +++ b/docs/sphinx/source/whatsnew/v0.13.1.rst @@ -70,3 +70,9 @@ Contributors * 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`) From d4d59bd319c59639a4be203ae4ba66e974d0f6c1 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Wed, 24 Sep 2025 11:28:54 -0400 Subject: [PATCH 3/6] correct a few sphinx issues --- docs/sphinx/source/whatsnew/v0.13.1.rst | 2 +- pvlib/irradiance.py | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.13.1.rst b/docs/sphinx/source/whatsnew/v0.13.1.rst index 28582870dd..f4b7e0ec9f 100644 --- a/docs/sphinx/source/whatsnew/v0.13.1.rst +++ b/docs/sphinx/source/whatsnew/v0.13.1.rst @@ -41,7 +41,7 @@ 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`) 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 From e80ff9bd0f1a24559aacf82d85e5e3fa39a156e8 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Wed, 24 Sep 2025 11:52:13 -0400 Subject: [PATCH 4/6] Update docs/sphinx/source/whatsnew/v0.13.1.rst Co-authored-by: Adam R. Jensen <39184289+AdamRJensen@users.noreply.github.com> --- docs/sphinx/source/whatsnew/v0.13.1.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sphinx/source/whatsnew/v0.13.1.rst b/docs/sphinx/source/whatsnew/v0.13.1.rst index f4b7e0ec9f..46f3b82df2 100644 --- a/docs/sphinx/source/whatsnew/v0.13.1.rst +++ b/docs/sphinx/source/whatsnew/v0.13.1.rst @@ -1,7 +1,7 @@ .. _whatsnew_0_13_1: -v0.13.1 (Anticipated September, 2025) +v0.13.1 (September 24, 2025) ------------------------------------- Deprecations From 6e8f915c81bd378282a216747e2ffa1f84e8aded Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Wed, 24 Sep 2025 12:03:13 -0400 Subject: [PATCH 5/6] updates from review Co-Authored-By: Echedey Luis <80125792+echedey-ls@users.noreply.github.com> --- docs/sphinx/source/whatsnew/v0.13.1.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/whatsnew/v0.13.1.rst b/docs/sphinx/source/whatsnew/v0.13.1.rst index 46f3b82df2..00e117b86b 100644 --- a/docs/sphinx/source/whatsnew/v0.13.1.rst +++ b/docs/sphinx/source/whatsnew/v0.13.1.rst @@ -6,8 +6,8 @@ v0.13.1 (September 24, 2025) 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 @@ -76,3 +76,4 @@ Contributors * Anton Driesse (:ghuser:`adriesse`) * Mark Mikofski (:ghuser:`mikofski`) * Mathias Aschwanden (:ghuser:`maschwanden`) +* :ghuser:`leopardracer` From 0084bf9d5a8212ef9f28dd7c97b02875406274d0 Mon Sep 17 00:00:00 2001 From: Kevin Anderson Date: Wed, 24 Sep 2025 12:05:32 -0400 Subject: [PATCH 6/6] remove :term: from missing items Co-Authored-By: RDaxini <143435106+RDaxini@users.noreply.github.com> --- docs/sphinx/source/user_guide/modeling_topics/spectrum.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) 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]_ | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+