Merge branch 'main' into cross-axis-whatever-name-consistent-name

Author: echedey-ls

docs/sphinx/source/reference/irradiance/decomposition.rst

@@ -16,6 +16,4 @@ DNI estimation models
    irradiance.orgill_hollands
    irradiance.boland
    irradiance.campbell_norman
-   irradiance.gti_dirint
    irradiance.louche
-

docs/sphinx/source/reference/irradiance/index.rst

@@ -9,6 +9,7 @@ Irradiance
    class-methods
    components
    transposition
+   reverse-transposition
    decomposition
    clearness-index
    albedo

docs/sphinx/source/reference/irradiance/reverse-transposition.rst

@@ -0,0 +1,10 @@
+.. currentmodule:: pvlib
+
+Reverse transposition models
+----------------------------
+
+.. autosummary::
+   :toctree: ../generated/
+
+   irradiance.ghi_from_poa_driesse_2023
+   irradiance.gti_dirint

docs/sphinx/source/reference/irradiance/transposition.rst

@@ -15,4 +15,3 @@ Transposition models
    irradiance.klucher
    irradiance.reindl
    irradiance.king
-   irradiance.ghi_from_poa_driesse_2023

docs/sphinx/source/user_guide/modeling_topics/spectrum.rst

@@ -51,19 +51,19 @@ Reference [2]_.
 |                                                     +-----------------------------+         |         |      |      |      |            |           |
 |                                                     |:term:`precipitable_water`,  |   ✓     |    ✓    |  ✓   |   ✓  |  ✓   |     ✓      |   [2]_    |
 |                                                     +-----------------------------+         |         |      |      |      |            |           |
-|                                                     | :term:`aod`                 |         |         |      |      |      |            |           |
+|                                                     | 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]_    |
-|                                                     | :term:`clearsky_index`      |         |         |      |      |      |            |           |
+|                                                     | clearsky_index              |         |         |      |      |      |            |           |
 +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
 | :py:func:`PVSPEC <spectral_factor_pvspec>`          | :term:`airmass_absolute`,   |         |         |      |      |      |            |           |
 |                                                     +-----------------------------+   ✓     |    ✓    |  ✓   |  ✓   |  ✓   |            |   [5]_    |
-|                                                     | :term:`clearsky_index`      |         |         |      |      |      |            |           |
+|                                                     | clearsky_index              |         |         |      |      |      |            |           |
 +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
 | :py:func:`SAPM <spectral_factor_sapm>`              | :term:`airmass_absolute`    |         |         |      |      |      |            |   [6]_    |
 +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+

docs/sphinx/source/whatsnew.rst

@@ -6,6 +6,7 @@ What's New
 
 These are new features and improvements of note in each release.
 
+.. include:: whatsnew/v0.13.2.rst
 .. include:: whatsnew/v0.13.1.rst
 .. include:: whatsnew/v0.13.0.rst
 .. include:: whatsnew/v0.12.0.rst

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

@@ -1,16 +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`)
+* 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`)
 * Rename ``axis_tilt`` and ``cross_axis_tilt`` to ``axis_slope`` and ``cross_axis_slope`` all through the project. Affects:
@@ -32,8 +29,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`,
@@ -44,8 +42,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
 ~~~~~~~~~~~~~
@@ -55,19 +53,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
 ~~~~~~~~~~~~
@@ -76,22 +66,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`

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

@@ -0,0 +1,45 @@
+.. _whatsnew_0_13_2:
+
+
+v0.13.2 (Anticipated December, 2025)
+------------------------------------
+
+Breaking Changes
+~~~~~~~~~~~~~~~~
+
+
+Deprecations
+~~~~~~~~~~~~
+
+
+Bug fixes
+~~~~~~~~~
+
+
+Enhancements
+~~~~~~~~~~~~
+
+
+Documentation
+~~~~~~~~~~~~~
+
+
+Testing
+~~~~~~~
+
+
+Benchmarking
+~~~~~~~~~~~~
+
+
+Requirements
+~~~~~~~~~~~~
+
+
+Maintenance
+~~~~~~~~~~~
+
+
+Contributors
+~~~~~~~~~~~~
+

pvlib/iotools/meteonorm.py

@@ -532,19 +532,21 @@ def _get_meteonorm(
 
     # Check for None type in case of TMY request
     # Check for DateParseError in case of relative times, e.g., '+3hours'
+    # TODO: remove ValueError when our minimum pandas version is high enough
+    # to make it unnecessary (2.0?)
     if (start is not None) & (start != 'now'):
         try:
             start = pd.Timestamp(start)
             start = start.tz_localize("UTC") if start.tzinfo is None else start
             start = start.strftime("%Y-%m-%dT%H:%M:%SZ")
-        except DateParseError:
+        except (ValueError, DateParseError):
             pass
     if (end is not None) & (end != 'now'):
         try:
             end = pd.Timestamp(end)
             end = end.tz_localize("UTC") if end.tzinfo is None else end
             end = end.strftime("%Y-%m-%dT%H:%M:%SZ")
-        except DateParseError:
+        except (ValueError, DateParseError):
             pass
 
     params = {

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
     ------
@@ -796,7 +796,7 @@ def haydavies(surface_tilt, surface_azimuth, dhi, dni, dni_extra,
             * sky_diffuse: Total sky diffuse
             * isotropic
             * circumsolar
-            * horizon
+            * horizon (always zero, not accounted for by the Hay-Davies model)
 
     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