paths, names, reference

Author: cwhanse

pvlib/ivtools/convert.py

@@ -1,8 +1,9 @@
 """
-The ``sdm`` module contains functions to fit single diode models.
+The ``convert`` module contains functions to convert between single diode
+models.
 
-Function names should follow the pattern "fit_" + name of model + "_" +
- fitting method.
+Function names should follow the pattern "convert_" + name of source model +
+ "_" + name of target method + "_" + name of conversion method.
 
 """
 
@@ -132,12 +133,13 @@ def convert_cec_pvsyst(cec_model, cells_in_series, method='Nelder-Mead',
 
     See Also
     --------
-    pvlib.ivtools.sdm.convert_pvsyst_cec
+    pvlib.ivtools.convert.convert_pvsyst_cec
 
     References
     ----------
     .. [1] L. Deville et al., "Parameter Translation for Photovoltaic Single
-       Diode Models", submitted. 2024
+       Diode Models", Journal of Photovoltaics, vol. 15(3), pp. 451-457,
+       May 2025. :doi:`10.1109/jphotov.2025.3539319`
 
     .. [2] "IEC 61853-3 Photovoltaic (PV) module performance testing and energy
        rating - Part 3: Energy rating of PV modules". IEC, Geneva, 2018.
@@ -276,12 +278,13 @@ def convert_pvsyst_cec(pvsyst_model, method='Nelder-Mead', options=None):
 
     See Also
     --------
-    pvlib.ivtools.sdm.convert_cec_pvsyst
+    pvlib.ivtools.convert.convert_cec_pvsyst
 
     References
     ----------
     .. [1] L. Deville et al., "Parameter Translation for Photovoltaic Single
-       Diode Models", submitted. 2024.
+       Diode Models", Journal of Photovoltaics, vol. 15(3), pp. 451-457,
+       May 2025. :doi:`10.1109/jphotov.2025.3539319`
 
     .. [2] "IEC 61853-3 Photovoltaic (PV) module performance testing and energy
        rating - Part 3: Energy rating of PV modules". IEC, Geneva, 2018.

tests/ivtools/test_convert.py

@@ -1,5 +1,5 @@
 import numpy as np
-from pvlib.ivtools import sdm
+from pvlib.ivtools import convert
 
 
 def test_convert_cec_pvsyst():
@@ -8,7 +8,7 @@ def test_convert_cec_pvsyst():
                     'EgRef': 1.121, 'dEgdT': -0.0002677,
                     'R_s': 0.159916, 'R_sh_ref': 113.991, 'a_ref': 1.59068,
                     'Adjust': 6.42247, 'alpha_sc': 0.00629}
-    trina660_pvsyst_est = sdm.convert_cec_pvsyst(trina660_cec,
+    trina660_pvsyst_est = convert.convert_cec_pvsyst(trina660_cec,
                                                  cells_in_series)
     pvsyst_expected = {'alpha_sc': 0.007478218748188788,
                        'I_L_ref': 18.227679597516214,
@@ -32,7 +32,7 @@ def test_convert_pvsyst_cec():
                        'R_s': 0.156, 'R_sh_ref': 200, 'R_sh_0': 800,
                        'R_sh_exp': 5.5, 'gamma_ref': 1.002, 'mu_gamma': 1e-3,
                        'cells_in_series': 66}
-    trina660_cec_est = sdm.convert_pvsyst_cec(trina660_pvsyst)
+    trina660_cec_est = convert.convert_pvsyst_cec(trina660_pvsyst)
     cec_expected = {'alpha_sc': 0.0074,
                     'I_L_ref': 18.05154226834071,
                     'I_o_ref': 2.6863417875143392e-14,