Remove irradiance.py deprecations; finalize v0.15.0 (#2666)

* remove expired pvlib.irradiance deprecations

* whatsnew

* bump release date

* Update docs/sphinx/source/whatsnew/v0.15.0.rst

* remove unused imports

* update release date

Author: kandersolar

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.15.0.rst
 .. include:: whatsnew/v0.14.0.rst
 .. include:: whatsnew/v0.13.1.rst
 .. include:: whatsnew/v0.13.0.rst

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

@@ -0,0 +1,28 @@
+.. _whatsnew_0_15_0:
+
+
+v0.15.0 (Feb 3, 2026)
+---------------------
+
+Breaking Changes
+~~~~~~~~~~~~~~~~
+* Removed expired parameter name deprecations (:issue:`2662`, :pull:`2666`):
+
+  - Parameter ``clearsky_ghi`` in :py:func:`pvlib.irradiance.clearsky_index`
+  - Parameters ``ghi_clearsky`` and ``dni_clearsky`` in :py:func:`pvlib.irradiance.dirindex`
+  - Parameter ``clearsky_dni`` in :py:func:`pvlib.irradiance.dni`
+
+Documentation
+~~~~~~~~~~~~~
+- Update gallery examples to work with ``pandas==3`` (:pull:`2664`).
+
+Contributors
+~~~~~~~~~~~~
+* Echedey Luis (:ghuser:`echedey-ls`)
+* Aman Srivastava (:ghuser:`aman-coder03`)
+* Cliff Hansen (:ghuser:`cwhanse`)
+* Adam R. Jensen (:ghuser:`adamrjensen`)
+* Will Holmgren (:ghuser:`wholmgren`)
+* Rajiv Daxini (:ghuser:`RDaxini`)
+* Anton Driesse (:ghuser:`adriesse`)
+* Kevin Anderson (:ghuser:`kandersolar`)

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

@@ -16,7 +16,7 @@
 from pvlib import atmosphere, solarposition, tools
 import pvlib  # used to avoid dni name collision in complete_irradiance
 
-from pvlib._deprecation import pvlibDeprecationWarning, renamed_kwarg_warning
+from pvlib._deprecation import pvlibDeprecationWarning
 import warnings
 
 
@@ -1613,11 +1613,6 @@ def ghi_from_poa_driesse_2023(surface_tilt, surface_azimuth,
         return ghi
 
 
-@renamed_kwarg_warning(
-    since='0.11.2',
-    old_param_name='clearsky_ghi',
-    new_param_name='ghi_clear',
-    removal="0.14.0")
 def clearsky_index(ghi, ghi_clear, max_clearsky_index=2.0):
     """
     Calculate the clearsky index.
@@ -2156,16 +2151,6 @@ def _dirint_bins(times, kt_prime, zenith, w, delta_kt_prime):
     return kt_prime_bin, zenith_bin, w_bin, delta_kt_prime_bin
 
 
-@renamed_kwarg_warning(
-    since='0.11.2',
-    old_param_name='ghi_clearsky',
-    new_param_name='ghi_clear',
-    removal="0.14.0")
-@renamed_kwarg_warning(
-    since='0.11.2',
-    old_param_name='dni_clearsky',
-    new_param_name='dni_clear',
-    removal="0.14.0")
 def dirindex(ghi, ghi_clear, dni_clear, zenith, times, pressure=101325.,
              use_delta_kt_prime=True, temp_dew=None, min_cos_zenith=0.065,
              max_zenith=87):
@@ -3662,11 +3647,6 @@ def _get_dirint_coeffs():
     return coeffs[1:, 1:, :, :]
 
 
-@renamed_kwarg_warning(
-    since='0.11.2',
-    old_param_name='clearsky_dni',
-    new_param_name='dni_clear',
-    removal="0.14.0")
 def dni(ghi, dhi, zenith, dni_clear=None, clearsky_tolerance=1.1,
         zenith_threshold_for_zero_dni=88.0,
         zenith_threshold_for_clearsky_limit=80.0):

pvlib/irradiance.py

@@ -16,7 +16,6 @@
     assert_series_equal,
     requires_ephem,
     requires_numba,
-    fail_on_pvlib_version,
 )
 
 from pvlib._deprecation import pvlibDeprecationWarning
@@ -1110,20 +1109,6 @@ def test_dirindex(times):
         equal_nan=True)
 
 
-@fail_on_pvlib_version("0.14")
-def test_dirindex_ghi_clearsky_deprecation():
-    times = pd.DatetimeIndex(['2014-06-24T18-1200'])
-    ghi = pd.Series([1038.62], index=times)
-    ghi_clearsky = pd.Series([1042.48031487], index=times)
-    dni_clearsky = pd.Series([939.95469881], index=times)
-    zenith = pd.Series([10.56413562], index=times)
-    pressure, tdew = 93193, 10
-    with pytest.warns(pvlibDeprecationWarning, match='ghi_clear'):
-        irradiance.dirindex(
-            ghi=ghi, ghi_clearsky=ghi_clearsky, dni_clear=dni_clearsky,
-            zenith=zenith, times=times, pressure=pressure, temp_dew=tdew)
-
-
 def test_dirindex_min_cos_zenith_max_zenith():
     # map out behavior under difficult conditions with various
     # limiting kwargs settings
@@ -1155,19 +1140,6 @@ def test_dirindex_min_cos_zenith_max_zenith():
     assert_series_equal(out, expected)
 
 
-@fail_on_pvlib_version("0.14")
-def test_dirindex_dni_clearsky_deprecation():
-    times = pd.DatetimeIndex(['2014-06-24T12-0700', '2014-06-24T18-0700'])
-    ghi = pd.Series([0, 1], index=times)
-    ghi_clearsky = pd.Series([0, 1], index=times)
-    dni_clear = pd.Series([0, 5], index=times)
-    solar_zenith = pd.Series([90, 89.99], index=times)
-    with pytest.warns(pvlibDeprecationWarning, match='dni_clear'):
-        irradiance.dirindex(ghi, ghi_clearsky, dni_clearsky=dni_clear,
-                            zenith=solar_zenith, times=times,
-                            min_cos_zenith=0)
-
-
 def test_dni():
     ghi = pd.Series([90, 100, 100, 100, 100])
     dhi = pd.Series([100, 90, 50, 50, 50])
@@ -1186,17 +1158,6 @@ def test_dni():
                                    146.190220008, 573.685662283]))
 
 
-@fail_on_pvlib_version("0.14")
-def test_dni_dni_clearsky_deprecation():
-    ghi = pd.Series([90, 100, 100, 100, 100])
-    dhi = pd.Series([100, 90, 50, 50, 50])
-    zenith = pd.Series([80, 100, 85, 70, 85])
-    dni_clear = pd.Series([50, 50, 200, 50, 300])
-    with pytest.warns(pvlibDeprecationWarning, match='dni_clear'):
-        irradiance.dni(ghi, dhi, zenith,
-                       clearsky_dni=dni_clear, clearsky_tolerance=2)
-
-
 @pytest.mark.parametrize(
     'surface_tilt,surface_azimuth,solar_zenith,' +
     'solar_azimuth,aoi_expected,aoi_proj_expected',
@@ -1289,13 +1250,6 @@ def test_clearsky_index():
     assert_series_equal(out, expected)
 
 
-@fail_on_pvlib_version("0.14")
-def test_clearsky_index_clearsky_ghi_deprecation():
-    with pytest.warns(pvlibDeprecationWarning, match='ghi_clear'):
-        ghi, clearsky_ghi = 200, 300
-        irradiance.clearsky_index(ghi, clearsky_ghi=clearsky_ghi)
-
-
 def test_clearness_index():
     ghi = np.array([-1, 0, 1, 1000])
     solar_zenith = np.array([180, 90, 89.999, 0])