From 2b3d02e656f057e68f175f3096f38e66a15fb217 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Fri, 10 Jan 2025 11:55:30 -0700 Subject: [PATCH 01/27] Create model_comparison.txt --- .../source/user_guide/model_comparison.txt | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/sphinx/source/user_guide/model_comparison.txt diff --git a/docs/sphinx/source/user_guide/model_comparison.txt b/docs/sphinx/source/user_guide/model_comparison.txt new file mode 100644 index 0000000000..386f5b219e --- /dev/null +++ b/docs/sphinx/source/user_guide/model_comparison.txt @@ -0,0 +1,29 @@ +.. _modelcomparison: + +Model comparison tables +======================= + +Spectral mismatch models +------------------------ + +pvlib-python contains several models to estimate the spectral mismatch factor +using atmnopsheric variables such as air mass, or system and meteorological +data such as spectral response and spectral irradiance. An example +demonstrating the application of three pvlib-python spectral mismatch models +is also available: XXX. Here, a comparison of all models available in +pvlib-python is presented. An extended review of a wider range of models +available in the published literature may be found in Reference [X]. + +The table below summarises the models currently available in pvlib, the inputs +required, cell technologies for which model coefficients have been published, +source of data used for model development and validation, and references. + +| **Model** | **Inputs** | **Cell technology** | **Data source** | **Reference** | +|---------------------------------------------------------|------------|---------------------|-----------------|---------------| +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | | | | | +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | | | | | + From 3fd7894830f506315e13bbe966defaf0661379dd Mon Sep 17 00:00:00 2001 From: RDaxini Date: Fri, 10 Jan 2025 12:01:44 -0700 Subject: [PATCH 02/27] create --- docs/sphinx/source/user_guide/index.rst | 1 + .../user_guide/{model_comparison.txt => model_comparison.rst} | 0 2 files changed, 1 insertion(+) rename docs/sphinx/source/user_guide/{model_comparison.txt => model_comparison.rst} (100%) diff --git a/docs/sphinx/source/user_guide/index.rst b/docs/sphinx/source/user_guide/index.rst index 8ce48515c9..de4029764d 100644 --- a/docs/sphinx/source/user_guide/index.rst +++ b/docs/sphinx/source/user_guide/index.rst @@ -15,6 +15,7 @@ User Guide clearsky bifacial weather_data + model_comparison singlediode nomenclature faq diff --git a/docs/sphinx/source/user_guide/model_comparison.txt b/docs/sphinx/source/user_guide/model_comparison.rst similarity index 100% rename from docs/sphinx/source/user_guide/model_comparison.txt rename to docs/sphinx/source/user_guide/model_comparison.rst From b2e99bd1d8d2cef4ede1da63e361895f21dce028 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Fri, 10 Jan 2025 15:03:37 -0700 Subject: [PATCH 03/27] correct table formatting --- .../source/user_guide/model_comparison.rst | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/docs/sphinx/source/user_guide/model_comparison.rst b/docs/sphinx/source/user_guide/model_comparison.rst index 386f5b219e..88097c66c4 100644 --- a/docs/sphinx/source/user_guide/model_comparison.rst +++ b/docs/sphinx/source/user_guide/model_comparison.rst @@ -3,6 +3,8 @@ Model comparison tables ======================= +Intro? + Spectral mismatch models ------------------------ @@ -18,12 +20,14 @@ The table below summarises the models currently available in pvlib, the inputs required, cell technologies for which model coefficients have been published, source of data used for model development and validation, and references. -| **Model** | **Inputs** | **Cell technology** | **Data source** | **Reference** | -|---------------------------------------------------------|------------|---------------------|-----------------|---------------| -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | | | | | -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | | | | | -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | | | | | -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | | | | | -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | | | | | -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ +| Model | Inputs | Cell technology | Data source | Reference | ++=========================================================+========+=================+=============+===========+ +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | | | | | +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | | | | | +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ From 3560eb0e87b51533409cb6adcdb4302efd46c9ba Mon Sep 17 00:00:00 2001 From: RDaxini Date: Fri, 10 Jan 2025 15:25:32 -0700 Subject: [PATCH 04/27] try forcing new row between jrc and pvspec --- docs/sphinx/source/user_guide/model_comparison.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/sphinx/source/user_guide/model_comparison.rst b/docs/sphinx/source/user_guide/model_comparison.rst index 88097c66c4..f74056adbc 100644 --- a/docs/sphinx/source/user_guide/model_comparison.rst +++ b/docs/sphinx/source/user_guide/model_comparison.rst @@ -24,10 +24,16 @@ source of data used for model development and validation, and references. | Model | Inputs | Cell technology | Data source | Reference | +=========================================================+========+=================+=============+===========+ | :py:func:`~pvlib.spectrum.spectral_factor_caballero` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_sapm` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_jrc` | | | | | ++---------------------------------------------------------+--------+-----------------+-------------+-----------+ | :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | | | | | +---------------------------------------------------------+--------+-----------------+-------------+-----------+ + From 23c92f7b43118254db2a0785f1e15c67e91d2fbc Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 13 Jan 2025 15:40:35 -0700 Subject: [PATCH 05/27] Update model_comparison.rst --- .../source/user_guide/model_comparison.rst | 39 ++++++++++--------- 1 file changed, 20 insertions(+), 19 deletions(-) diff --git a/docs/sphinx/source/user_guide/model_comparison.rst b/docs/sphinx/source/user_guide/model_comparison.rst index f74056adbc..adf6443eee 100644 --- a/docs/sphinx/source/user_guide/model_comparison.rst +++ b/docs/sphinx/source/user_guide/model_comparison.rst @@ -9,31 +9,32 @@ Spectral mismatch models ------------------------ pvlib-python contains several models to estimate the spectral mismatch factor -using atmnopsheric variables such as air mass, or system and meteorological +using atmospheric variables such as air mass, or system and meteorological data such as spectral response and spectral irradiance. An example demonstrating the application of three pvlib-python spectral mismatch models -is also available: XXX. Here, a comparison of all models available in -pvlib-python is presented. An extended review of a wider range of models -available in the published literature may be found in Reference [X]. +is also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py. Here, +a comparison of all models available in pvlib-python is presented. An extended +review of a wider range of models available in the published literature may be +found in Reference [X]. The table below summarises the models currently available in pvlib, the inputs required, cell technologies for which model coefficients have been published, source of data used for model development and validation, and references. -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ -| Model | Inputs | Cell technology | Data source | Reference | -+=========================================================+========+=================+=============+===========+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | | | | | -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | | | | | -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | | | | | -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | | | | | -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | | | | | -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | | | | | -+---------------------------------------------------------+--------+-----------------+-------------+-----------+ ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +| Model | Inputs | Cell technology | Data source | Reference | ++=========================================================+==============================================================+=================+===================+===========+ +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | absolute airmass, precipitable water, aerosol optical depth | Multiple | SMARTS, measured | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | absolute airmass, precipitable water | mSi, CdTe | SMARTS+TMY, field | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | absolute airmass | Multiple | Field | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | absolute airmass, clearsky index | Multiple | Field | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | absolute airmass, clearsky index | Multiple | Field | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, spectral irradiance | - | - | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ From 6d21d7e138b59d8b995cf915073f3db3847e8f67 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 13 Jan 2025 15:43:32 -0700 Subject: [PATCH 06/27] Update model_comparison.rst --- docs/sphinx/source/user_guide/model_comparison.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/sphinx/source/user_guide/model_comparison.rst b/docs/sphinx/source/user_guide/model_comparison.rst index adf6443eee..c44f84ff72 100644 --- a/docs/sphinx/source/user_guide/model_comparison.rst +++ b/docs/sphinx/source/user_guide/model_comparison.rst @@ -3,7 +3,7 @@ Model comparison tables ======================= -Intro? +Intro Spectral mismatch models ------------------------ @@ -38,3 +38,7 @@ source of data used for model development and validation, and references. +---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ +link param(case of multiple?), list tech, parameterisation? + +References +---------- From bcf3ff9e4d147255c7ce2f0905e1908683ed20ec Mon Sep 17 00:00:00 2001 From: RDaxini Date: Tue, 28 Jan 2025 14:51:36 -0700 Subject: [PATCH 07/27] create user guide subection --- docs/sphinx/source/user_guide/index.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/sphinx/source/user_guide/index.rst b/docs/sphinx/source/user_guide/index.rst index ad61a14b80..4950dd1453 100644 --- a/docs/sphinx/source/user_guide/index.rst +++ b/docs/sphinx/source/user_guide/index.rst @@ -9,24 +9,29 @@ This user guide is an overview and explains some of the key features of pvlib. .. toctree:: :caption: Getting started :maxdepth: 2 - + package_overview installation introtutorial - + .. toctree:: :caption: Modeling topics :maxdepth: 2 - + pvsystem modelchain timetimezones bifacial clearsky weather_data - model_comparison singlediode +.. toctree:: + :caption: Model comparisons + :maxdepth: 2 + + model_comparison + .. toctree:: :caption: Extras :maxdepth: 2 From 0be2e469c53b03833550149c2e2065f0c3dbe19d Mon Sep 17 00:00:00 2001 From: RDaxini Date: Tue, 28 Jan 2025 15:15:28 -0700 Subject: [PATCH 08/27] rename, fix gallery example link, update cell tech --- .../source/user_guide/model_comparison.rst | 47 +++++++++---------- 1 file changed, 22 insertions(+), 25 deletions(-) diff --git a/docs/sphinx/source/user_guide/model_comparison.rst b/docs/sphinx/source/user_guide/model_comparison.rst index c44f84ff72..be3d9c9497 100644 --- a/docs/sphinx/source/user_guide/model_comparison.rst +++ b/docs/sphinx/source/user_guide/model_comparison.rst @@ -1,18 +1,13 @@ -.. _modelcomparison: - -Model comparison tables -======================= - -Intro +.. _spectral_correction_comparison: Spectral mismatch models ------------------------- +======================== pvlib-python contains several models to estimate the spectral mismatch factor using atmospheric variables such as air mass, or system and meteorological data such as spectral response and spectral irradiance. An example demonstrating the application of three pvlib-python spectral mismatch models -is also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py. Here, +is also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py`. Here, a comparison of all models available in pvlib-python is presented. An extended review of a wider range of models available in the published literature may be found in Reference [X]. @@ -21,24 +16,26 @@ The table below summarises the models currently available in pvlib, the inputs required, cell technologies for which model coefficients have been published, source of data used for model development and validation, and references. -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ -| Model | Inputs | Cell technology | Data source | Reference | -+=========================================================+==============================================================+=================+===================+===========+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | absolute airmass, precipitable water, aerosol optical depth | Multiple | SMARTS, measured | [X] | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | absolute airmass, precipitable water | mSi, CdTe | SMARTS+TMY, field | [X] | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | absolute airmass | Multiple | Field | [X] | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | absolute airmass, clearsky index | Multiple | Field | [X] | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | absolute airmass, clearsky index | Multiple | Field | [X] | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, spectral irradiance | - | - | [X] | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+-------------------+-----------+ - ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ +| Model | Inputs | Cell technology | Reference | ++=========================================================+==============================================================+=================+============+ +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | absolute airmass, precipitable water, aerosol optical depth | CdTe, mono-Si, | | +| | | poly-Si, CIGS, | [X] | +| | | aSi, perovskite | | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | absolute airmass, precipitable water | mSi, CdTe | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | absolute airmass | Multiple | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | absolute airmass, clearsky index | CdTe, mono-Si, | | +| | | poly-Si, CIGS, | [X] | +| | | aSi | | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | absolute airmass, clearsky index | CdTe, poly-Si | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, spectral irradiance | - | [X] | ++---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -link param(case of multiple?), list tech, parameterisation? References ---------- From a5d4d9b1e378c5784fd39b1ea505d8ccd191649f Mon Sep 17 00:00:00 2001 From: RDaxini Date: Tue, 28 Jan 2025 16:52:14 -0700 Subject: [PATCH 09/27] update name and location --- docs/sphinx/source/user_guide/index.rst | 7 +------ .../user_guide/{model_comparison.rst => spectrum.rst} | 6 +++--- 2 files changed, 4 insertions(+), 9 deletions(-) rename docs/sphinx/source/user_guide/{model_comparison.rst => spectrum.rst} (97%) diff --git a/docs/sphinx/source/user_guide/index.rst b/docs/sphinx/source/user_guide/index.rst index 4950dd1453..11a3aec2f6 100644 --- a/docs/sphinx/source/user_guide/index.rst +++ b/docs/sphinx/source/user_guide/index.rst @@ -21,17 +21,12 @@ This user guide is an overview and explains some of the key features of pvlib. pvsystem modelchain timetimezones + spectrum bifacial clearsky weather_data singlediode -.. toctree:: - :caption: Model comparisons - :maxdepth: 2 - - model_comparison - .. toctree:: :caption: Extras :maxdepth: 2 diff --git a/docs/sphinx/source/user_guide/model_comparison.rst b/docs/sphinx/source/user_guide/spectrum.rst similarity index 97% rename from docs/sphinx/source/user_guide/model_comparison.rst rename to docs/sphinx/source/user_guide/spectrum.rst index be3d9c9497..11574fa351 100644 --- a/docs/sphinx/source/user_guide/model_comparison.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -1,7 +1,7 @@ -.. _spectral_correction_comparison: +.. _spectrum_user_guide: -Spectral mismatch models -======================== +Spectral mismatch +================= pvlib-python contains several models to estimate the spectral mismatch factor using atmospheric variables such as air mass, or system and meteorological From 7e79344173144f30c24a03083865dbec4d2aee9c Mon Sep 17 00:00:00 2001 From: RDaxini Date: Tue, 28 Jan 2025 16:57:16 -0700 Subject: [PATCH 10/27] rename, add layer --- docs/sphinx/source/user_guide/spectrum.rst | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index 11574fa351..a3b1a7b169 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -1,7 +1,12 @@ .. _spectrum_user_guide: -Spectral mismatch -================= +Spectrum +======== + +intro + +Spectral mismatch models +------------------------ pvlib-python contains several models to estimate the spectral mismatch factor using atmospheric variables such as air mass, or system and meteorological From 9c588a97f516613f0a84dd5c2348da234c90e131 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 3 Feb 2025 08:58:45 -0700 Subject: [PATCH 11/27] references, table format, updated text --- docs/sphinx/source/user_guide/spectrum.rst | 54 ++++++++++++++++++---- 1 file changed, 44 insertions(+), 10 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index a3b1a7b169..02041aa94d 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -15,32 +15,66 @@ demonstrating the application of three pvlib-python spectral mismatch models is also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py`. Here, a comparison of all models available in pvlib-python is presented. An extended review of a wider range of models available in the published literature may be -found in Reference [X]. +found in Reference [1]_. The table below summarises the models currently available in pvlib, the inputs required, cell technologies for which model coefficients have been published, -source of data used for model development and validation, and references. +and references. Note that while most models are validated for specific cell +technologies, the Sandia Array Performance Model (SAPM) and spectral mismatch +calculation are not specific to cell type; the former is validated for a range +of commerical module products. +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ | Model | Inputs | Cell technology | Reference | +=========================================================+==============================================================+=================+============+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | absolute airmass, precipitable water, aerosol optical depth | CdTe, mono-Si, | | -| | | poly-Si, CIGS, | [X] | +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | absolute airmass, | CdTe, | | +| | precipitable water, | mono-Si, | | +| | aerosol optical depth | poly-Si, CIGS, | [2]_ | | | | aSi, perovskite | | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | absolute airmass, precipitable water | mSi, CdTe | [X] | +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | absolute airmass, | CdTe, | | +| | precipitable water | poly-Si | [3]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | absolute airmass | Multiple | [X] | +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | absolute airmass | Multiple | [4]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | absolute airmass, clearsky index | CdTe, mono-Si, | | -| | | poly-Si, CIGS, | [X] | +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | absolute airmass, | CdTe, | | +| | clearsky index | poly-Si, | | +| | | mono-Si, | | +| | | CIGS, | [5]_ | | | | aSi | | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | absolute airmass, clearsky index | CdTe, poly-Si | [X] | +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | absolute airmass, clearsky index | CdTe, | | +| | | poly-Si | [6]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, spectral irradiance | - | [X] | +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, spectral irradiance | - | [7]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ References ---------- +.. [1] R. Daxini and Y. Wu, "Review of methods to account for the solar + spectral influence on photovoltaic device performance," Energy, + vol. 286, p. 129461, Jan. 2024. :doi:`10.1016/j.energy.2023.129461` +.. [2] J. A. Caballero, E. Fernández, M. Theristis, F. Almonacid, and + G. Nofuentes, "Spectral Corrections Based on Air Mass, Aerosol Optical + Depth and Precipitable Water for PV Performance Modeling," IEEE Journal + of Photovoltaics, vol. 8, no. 2, pp. 552–558, Mar. 2018. + :doi:`10.1109/JPHOTOV.2017.2787019` +.. [3] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module + Performance Based on Air Mass and Precipitable Water," 2016 IEEE 43rd + Photovoltaic Specialists Conference (PVSC), Portland, OR, USA, 2016, + pp. 3696-3699. :doi:`10.1109/PVSC.2016.7749836` +.. [4] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array + Performance Model, Sandia National Laboratories, Albuquerque, NM, USA, + Tech. Rep. SAND2004-3535, Aug. 2004. :doi:`10.2172/919131` +.. [5] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the + PVSPEC Model of Photovoltaic Spectral Mismatch Factor," in Proc. 2020 + IEEE 47th Photovoltaic Specialists Conference (PVSC), Calgary, AB, + Canada, 2020, pp. 1–6. :doi:`10.1109/PVSC45281.2020.9300932` +.. [6] T. Huld, T. C. Sample, and E. D. Dunlop, "A Simple Model for Estimating + the Influence of Spectral Variations on the Performance of PV Modules, + "AerosolSolar Energy Materials and Solar Cells, vol. 92, no. 12, + pp. 1645–1656, Dec. 2008. :doi:`10.1016/j.solmat.2008.07.016` +.. [7] IEC 60904-7:2019, Photovoltaic devices — Part 7: Computation of the + spectral mismatch correction for measurements of photovoltaic devices, + International Electrotechnical Commission, Geneva, Switzerland, 2019. \ No newline at end of file From 13f02e1598c085c20955b64b31f65008e4a5f09f Mon Sep 17 00:00:00 2001 From: RDaxini Date: Tue, 11 Feb 2025 10:40:45 -0700 Subject: [PATCH 12/27] add intro --- docs/sphinx/source/user_guide/spectrum.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index 02041aa94d..6ffb6426e9 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -3,7 +3,15 @@ Spectrum ======== -intro +The spectrum functionality of pvlib-python includes simulating clear sky +spectral irradiance curves, calculating the spectral mismatch factor for +a range of single-junction PV cell technologies, and other calculations +such as converting between spectral response and EQE, and computing average +photon energy values from spectral irradiance data. + +This user guide page summarizes some of pvlib-python's spectrum-related +capabilities, starting with a summary of spectral mismatch estimation models +available in pvlib-python. Spectral mismatch models ------------------------ From 3bbd3a32c05e173eaa6f67a27f4fba9f20d2c8d6 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 09:31:17 -0600 Subject: [PATCH 13/27] correct huld reference --- docs/sphinx/source/user_guide/spectrum.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index 6ffb6426e9..4bebabfc4c 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -79,10 +79,9 @@ References PVSPEC Model of Photovoltaic Spectral Mismatch Factor," in Proc. 2020 IEEE 47th Photovoltaic Specialists Conference (PVSC), Calgary, AB, Canada, 2020, pp. 1–6. :doi:`10.1109/PVSC45281.2020.9300932` -.. [6] T. Huld, T. C. Sample, and E. D. Dunlop, "A Simple Model for Estimating - the Influence of Spectral Variations on the Performance of PV Modules, - "AerosolSolar Energy Materials and Solar Cells, vol. 92, no. 12, - pp. 1645–1656, Dec. 2008. :doi:`10.1016/j.solmat.2008.07.016` +.. [6] H. Thomas, S. Tony, and D. Ewan, “A Simple Model for Estimating the + Influence of Spectrum Variations on PV Performance,” pp. 3385–3389, Nov. + 2009, :doi:10.4229/24THEUPVSEC2009-4AV.3.27 .. [7] IEC 60904-7:2019, Photovoltaic devices — Part 7: Computation of the spectral mismatch correction for measurements of photovoltaic devices, International Electrotechnical Commission, Geneva, Switzerland, 2019. \ No newline at end of file From 1d901f6bef67a525ea11b643e14950f4b7e2d8c7 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 09:34:36 -0600 Subject: [PATCH 14/27] use :term: role --- docs/sphinx/source/user_guide/spectrum.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index 4bebabfc4c..9616892177 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -35,26 +35,26 @@ of commerical module products. +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ | Model | Inputs | Cell technology | Reference | +=========================================================+==============================================================+=================+============+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | absolute airmass, | CdTe, | | -| | precipitable water, | mono-Si, | | +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute airmass`, | CdTe, | | +| | :term:`precipitable water`, | mono-Si, | | | | aerosol optical depth | poly-Si, CIGS, | [2]_ | | | | aSi, perovskite | | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | absolute airmass, | CdTe, | | -| | precipitable water | poly-Si | [3]_ | +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute airmass`, | CdTe, | | +| | :term:`precipitable water` | poly-Si | [3]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | absolute airmass | Multiple | [4]_ | +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute airmass` | Multiple | [4]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | absolute airmass, | CdTe, | | +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute airmass`, | CdTe, | | | | clearsky index | poly-Si, | | | | | mono-Si, | | | | | CIGS, | [5]_ | | | | aSi | | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | absolute airmass, clearsky index | CdTe, | | +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`absolute airmass`, clearsky index | CdTe, | | | | | poly-Si | [6]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, spectral irradiance | - | [7]_ | +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, :term:`spectra` | - | [7]_ | +---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ From 7048766a8df6076f5dc6c4ea13f8038aa1d53d90 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 09:44:30 -0600 Subject: [PATCH 15/27] reduce width --- docs/sphinx/source/user_guide/spectrum.rst | 51 ++++++++++++---------- 1 file changed, 27 insertions(+), 24 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index 9616892177..73e4daf8ae 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -32,30 +32,33 @@ technologies, the Sandia Array Performance Model (SAPM) and spectral mismatch calculation are not specific to cell type; the former is validated for a range of commerical module products. -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| Model | Inputs | Cell technology | Reference | -+=========================================================+==============================================================+=================+============+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute airmass`, | CdTe, | | -| | :term:`precipitable water`, | mono-Si, | | -| | aerosol optical depth | poly-Si, CIGS, | [2]_ | -| | | aSi, perovskite | | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute airmass`, | CdTe, | | -| | :term:`precipitable water` | poly-Si | [3]_ | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute airmass` | Multiple | [4]_ | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute airmass`, | CdTe, | | -| | clearsky index | poly-Si, | | -| | | mono-Si, | | -| | | CIGS, | [5]_ | -| | | aSi | | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`absolute airmass`, clearsky index | CdTe, | | -| | | poly-Si | [6]_ | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, :term:`spectra` | - | [7]_ | -+---------------------------------------------------------+--------------------------------------------------------------+-----------------+------------+ ++---------------------------------------------------------+----------------------------+-----------------------------+ +| Model | Inputs | Cell technology | Reference | ++=========================================================+============================+=============================+ +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute airmass`, | CdTe, | | +| | :term:`precipitable water`,| mono-Si, | | +| | aerosol optical depth | poly-Si, | [2]_ | +| | | aSi, | | +| | | CIGS, | | +| | | Perovskite | | ++---------------------------------------------------------+----------------------------+-----------------------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute airmass`, | CdTe, | | +| | :term:`precipitable water` | poly-Si | [3]_ | ++---------------------------------------------------------+----------------------------+-----------------------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute airmass` | Multiple | [4]_ | ++---------------------------------------------------------+----------------------------+-----------------------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute airmass`, | CdTe, | | +| | clearsky index | poly-Si, | | +| | | mono-Si, | | +| | | CIGS, | [5]_ | +| | | aSi | | ++---------------------------------------------------------+----------------------------+-----------------------------+ +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`absolute airmass`, | CdTe, | | +| | clearsky index | poly-Si | [6]_ | ++---------------------------------------------------------+----------------------------+-----------------------------+ +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | - | | +| | :term:`spectra` | | | ++---------------------------------------------------------+----------------------------+-----------------------------+ References From 106982a6892e0fdab761585ca8ce36780314f655 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 09:46:05 -0600 Subject: [PATCH 16/27] update terms --- docs/sphinx/source/user_guide/spectrum.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index 73e4daf8ae..f6de8dfaf8 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -35,25 +35,25 @@ of commerical module products. +---------------------------------------------------------+----------------------------+-----------------------------+ | Model | Inputs | Cell technology | Reference | +=========================================================+============================+=============================+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute airmass`, | CdTe, | | -| | :term:`precipitable water`,| mono-Si, | | +| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute_airmass`, | CdTe, | | +| | :term:`precipitable_water`,| mono-Si, | | | | aerosol optical depth | poly-Si, | [2]_ | | | | aSi, | | | | | CIGS, | | | | | Perovskite | | +---------------------------------------------------------+----------------------------+-----------------------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute airmass`, | CdTe, | | -| | :term:`precipitable water` | poly-Si | [3]_ | +| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute_airmass`, | CdTe, | | +| | :term:`precipitable_water` | poly-Si | [3]_ | +---------------------------------------------------------+----------------------------+-----------------------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute airmass` | Multiple | [4]_ | +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute_airmass` | Multiple | [4]_ | +---------------------------------------------------------+----------------------------+-----------------------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute airmass`, | CdTe, | | +| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute_airmass`, | CdTe, | | | | clearsky index | poly-Si, | | | | | mono-Si, | | | | | CIGS, | [5]_ | | | | aSi | | +---------------------------------------------------------+----------------------------+-----------------------------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`absolute airmass`, | CdTe, | | +| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`relative_airmass`, | CdTe, | | | | clearsky index | poly-Si | [6]_ | +---------------------------------------------------------+----------------------------+-----------------------------+ | :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | - | | From 74edb156724f51430824e95e2ab9344ad8f6c608 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 09:47:46 -0600 Subject: [PATCH 17/27] `-` -> `any single junction` --- docs/sphinx/source/user_guide/spectrum.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/spectrum.rst index f6de8dfaf8..c94e29f048 100644 --- a/docs/sphinx/source/user_guide/spectrum.rst +++ b/docs/sphinx/source/user_guide/spectrum.rst @@ -56,8 +56,8 @@ of commerical module products. | :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`relative_airmass`, | CdTe, | | | | clearsky index | poly-Si | [6]_ | +---------------------------------------------------------+----------------------------+-----------------------------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | - | | -| | :term:`spectra` | | | +| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | Any single | | +| | :term:`spectra` | junction | | +---------------------------------------------------------+----------------------------+-----------------------------+ From ff22d12de7ab48931a4a8d8f1eec7c400e25d721 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 09:52:48 -0600 Subject: [PATCH 18/27] accommodate new user guide folder structure --- docs/sphinx/source/user_guide/{ => modeling_topics}/spectrum.rst | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/sphinx/source/user_guide/{ => modeling_topics}/spectrum.rst (100%) diff --git a/docs/sphinx/source/user_guide/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst similarity index 100% rename from docs/sphinx/source/user_guide/spectrum.rst rename to docs/sphinx/source/user_guide/modeling_topics/spectrum.rst From 9f6aab65c9ef344ff2e664373169494b302759fa Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 15:48:47 -0600 Subject: [PATCH 19/27] add captions back in --- docs/sphinx/source/user_guide/index.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/sphinx/source/user_guide/index.rst b/docs/sphinx/source/user_guide/index.rst index f434369584..07102a5630 100644 --- a/docs/sphinx/source/user_guide/index.rst +++ b/docs/sphinx/source/user_guide/index.rst @@ -16,6 +16,7 @@ This user guide is an overview and explains some of the key features of pvlib. .. toctree:: :maxdepth: 2 + :caption: Modeling topics modeling_topics/pvsystem modeling_topics/modelchain @@ -28,6 +29,7 @@ This user guide is an overview and explains some of the key features of pvlib. .. toctree:: :maxdepth: 2 + :caption: Extras extras/nomenclature extras/faq From 4df8ae20e3ef91e753acc23d33b898cb40c4809e Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 15:49:44 -0600 Subject: [PATCH 20/27] re-separate columns --- .../user_guide/modeling_topics/spectrum.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index c94e29f048..3a94da5db9 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -32,33 +32,33 @@ technologies, the Sandia Array Performance Model (SAPM) and spectral mismatch calculation are not specific to cell type; the former is validated for a range of commerical module products. -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ | Model | Inputs | Cell technology | Reference | -+=========================================================+============================+=============================+ ++=========================================================+============================+=================+===========+ | :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute_airmass`, | CdTe, | | | | :term:`precipitable_water`,| mono-Si, | | | | aerosol optical depth | poly-Si, | [2]_ | | | | aSi, | | | | | CIGS, | | | | | Perovskite | | -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute_airmass`, | CdTe, | | | | :term:`precipitable_water` | poly-Si | [3]_ | -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute_airmass` | Multiple | [4]_ | -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute_airmass`, | CdTe, | | | | clearsky index | poly-Si, | | | | | mono-Si, | | | | | CIGS, | [5]_ | | | | aSi | | -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`relative_airmass`, | CdTe, | | | | clearsky index | poly-Si | [6]_ | -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | Any single | | | | :term:`spectra` | junction | | -+---------------------------------------------------------+----------------------------+-----------------------------+ ++---------------------------------------------------------+----------------------------+-----------------+-----------+ References From 298caa8872c4c0c8545b27dcaccc723145521b75 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 15:59:14 -0600 Subject: [PATCH 21/27] add duramat sr library reference --- .../user_guide/modeling_topics/spectrum.rst | 43 +++++++++++-------- 1 file changed, 25 insertions(+), 18 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index 3a94da5db9..ba18a6dfb5 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -18,12 +18,13 @@ Spectral mismatch models pvlib-python contains several models to estimate the spectral mismatch factor using atmospheric variables such as air mass, or system and meteorological -data such as spectral response and spectral irradiance. An example -demonstrating the application of three pvlib-python spectral mismatch models -is also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py`. Here, -a comparison of all models available in pvlib-python is presented. An extended -review of a wider range of models available in the published literature may be -found in Reference [1]_. +data such as spectral response and spectral irradiance. Two separate examples +demonstrating the application of four pvlib-python spectral mismatch models +are also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py` and +Ref. [1]_, the latter of which also contains downloadable spectral response +and spectral irradiance data. On this page, a comparison of all models +available in pvlib-python is presented. An extended review of a wider range of +models available in the published literature may be found in Reference [2]_. The table below summarises the models currently available in pvlib, the inputs required, cell technologies for which model coefficients have been published, @@ -37,24 +38,24 @@ of commerical module products. +=========================================================+============================+=================+===========+ | :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute_airmass`, | CdTe, | | | | :term:`precipitable_water`,| mono-Si, | | -| | aerosol optical depth | poly-Si, | [2]_ | +| | aerosol optical depth | poly-Si, | [3]_ | | | | aSi, | | | | | CIGS, | | | | | Perovskite | | +---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute_airmass`, | CdTe, | | -| | :term:`precipitable_water` | poly-Si | [3]_ | +| | :term:`precipitable_water` | poly-Si | [4]_ | +---------------------------------------------------------+----------------------------+-----------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute_airmass` | Multiple | [4]_ | +| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute_airmass` | Multiple | [5]_ | +---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute_airmass`, | CdTe, | | | | clearsky index | poly-Si, | | | | | mono-Si, | | -| | | CIGS, | [5]_ | +| | | CIGS, | [6]_ | | | | aSi | | +---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`relative_airmass`, | CdTe, | | -| | clearsky index | poly-Si | [6]_ | +| | clearsky index | poly-Si | [7]_ | +---------------------------------------------------------+----------------------------+-----------------+-----------+ | :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | Any single | | | | :term:`spectra` | junction | | @@ -63,28 +64,34 @@ of commerical module products. References ---------- -.. [1] R. Daxini and Y. Wu, "Review of methods to account for the solar +.. [1] A. Driesse, J. S. Stein, and M. Theristis, "Global horizontal spectral + irradiance and module spectral response measurements: an open dataset + for PV research Sandia National Laboratories, ALbuquerque, NM, USA, Rep. + SAND2023-02045, 2023. Available: + https://datahub.duramat.org/dataset/module-sr-library + +.. [2] R. Daxini and Y. Wu, "Review of methods to account for the solar spectral influence on photovoltaic device performance," Energy, vol. 286, p. 129461, Jan. 2024. :doi:`10.1016/j.energy.2023.129461` -.. [2] J. A. Caballero, E. Fernández, M. Theristis, F. Almonacid, and +.. [3] J. A. Caballero, E. Fernández, M. Theristis, F. Almonacid, and G. Nofuentes, "Spectral Corrections Based on Air Mass, Aerosol Optical Depth and Precipitable Water for PV Performance Modeling," IEEE Journal of Photovoltaics, vol. 8, no. 2, pp. 552–558, Mar. 2018. :doi:`10.1109/JPHOTOV.2017.2787019` -.. [3] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module +.. [4] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module Performance Based on Air Mass and Precipitable Water," 2016 IEEE 43rd Photovoltaic Specialists Conference (PVSC), Portland, OR, USA, 2016, pp. 3696-3699. :doi:`10.1109/PVSC.2016.7749836` -.. [4] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array +.. [5] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array Performance Model, Sandia National Laboratories, Albuquerque, NM, USA, Tech. Rep. SAND2004-3535, Aug. 2004. :doi:`10.2172/919131` -.. [5] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the +.. [6] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the PVSPEC Model of Photovoltaic Spectral Mismatch Factor," in Proc. 2020 IEEE 47th Photovoltaic Specialists Conference (PVSC), Calgary, AB, Canada, 2020, pp. 1–6. :doi:`10.1109/PVSC45281.2020.9300932` -.. [6] H. Thomas, S. Tony, and D. Ewan, “A Simple Model for Estimating the +.. [7] H. Thomas, S. Tony, and D. Ewan, “A Simple Model for Estimating the Influence of Spectrum Variations on PV Performance,” pp. 3385–3389, Nov. 2009, :doi:10.4229/24THEUPVSEC2009-4AV.3.27 -.. [7] IEC 60904-7:2019, Photovoltaic devices — Part 7: Computation of the +.. [8] IEC 60904-7:2019, Photovoltaic devices — Part 7: Computation of the spectral mismatch correction for measurements of photovoltaic devices, International Electrotechnical Commission, Geneva, Switzerland, 2019. \ No newline at end of file From 3555be4c7cae33dcc0af33caff15206d52c4afa2 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 16:00:46 -0600 Subject: [PATCH 22/27] Update spectrum.rst --- docs/sphinx/source/user_guide/modeling_topics/spectrum.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index ba18a6dfb5..53cbce48df 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -21,8 +21,8 @@ using atmospheric variables such as air mass, or system and meteorological data such as spectral response and spectral irradiance. Two separate examples demonstrating the application of four pvlib-python spectral mismatch models are also available: :ref:`sphx_glr_gallery_spectrum_spectral_factor.py` and -Ref. [1]_, the latter of which also contains downloadable spectral response -and spectral irradiance data. On this page, a comparison of all models +Reference [1]_, the latter of which also contains downloadable spectral +response and spectral irradiance data. On this page, a comparison of all models available in pvlib-python is presented. An extended review of a wider range of models available in the published literature may be found in Reference [2]_. From eadf7347b076bd6011c3f717f25489fb812ce8e1 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 14 Apr 2025 16:12:55 -0600 Subject: [PATCH 23/27] fix doi link --- docs/sphinx/source/user_guide/modeling_topics/spectrum.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index 53cbce48df..c358c32c75 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -69,7 +69,6 @@ References for PV research Sandia National Laboratories, ALbuquerque, NM, USA, Rep. SAND2023-02045, 2023. Available: https://datahub.duramat.org/dataset/module-sr-library - .. [2] R. Daxini and Y. Wu, "Review of methods to account for the solar spectral influence on photovoltaic device performance," Energy, vol. 286, p. 129461, Jan. 2024. :doi:`10.1016/j.energy.2023.129461` @@ -91,7 +90,7 @@ References Canada, 2020, pp. 1–6. :doi:`10.1109/PVSC45281.2020.9300932` .. [7] H. Thomas, S. Tony, and D. Ewan, “A Simple Model for Estimating the Influence of Spectrum Variations on PV Performance,” pp. 3385–3389, Nov. - 2009, :doi:10.4229/24THEUPVSEC2009-4AV.3.27 + 2009, :doi:`10.4229/24THEUPVSEC2009-4AV.3.27` .. [8] IEC 60904-7:2019, Photovoltaic devices — Part 7: Computation of the spectral mismatch correction for measurements of photovoltaic devices, International Electrotechnical Commission, Geneva, Switzerland, 2019. \ No newline at end of file From 324f134fc63c3d23ab18242726cb43375212ad24 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 2 Jun 2025 15:31:59 -0600 Subject: [PATCH 24/27] Update spectrum.rst --- .../user_guide/modeling_topics/spectrum.rst | 118 ++++++++++++------ 1 file changed, 83 insertions(+), 35 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index c358c32c75..21c1a025f5 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -1,4 +1,6 @@ .. _spectrum_user_guide: +.. currentmodule:: pvlib.spectrum + Spectrum ======== @@ -13,6 +15,7 @@ This user guide page summarizes some of pvlib-python's spectrum-related capabilities, starting with a summary of spectral mismatch estimation models available in pvlib-python. + Spectral mismatch models ------------------------ @@ -33,33 +36,78 @@ technologies, the Sandia Array Performance Model (SAPM) and spectral mismatch calculation are not specific to cell type; the former is validated for a range of commerical module products. -+---------------------------------------------------------+----------------------------+-----------------+-----------+ -| Model | Inputs | Cell technology | Reference | -+=========================================================+============================+=================+===========+ -| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute_airmass`, | CdTe, | | -| | :term:`precipitable_water`,| mono-Si, | | -| | aerosol optical depth | poly-Si, | [3]_ | -| | | aSi, | | -| | | CIGS, | | -| | | Perovskite | | -+---------------------------------------------------------+----------------------------+-----------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute_airmass`, | CdTe, | | -| | :term:`precipitable_water` | poly-Si | [4]_ | -+---------------------------------------------------------+----------------------------+-----------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute_airmass` | Multiple | [5]_ | -+---------------------------------------------------------+----------------------------+-----------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute_airmass`, | CdTe, | | -| | clearsky index | poly-Si, | | -| | | mono-Si, | | -| | | CIGS, | [6]_ | -| | | aSi | | -+---------------------------------------------------------+----------------------------+-----------------+-----------+ -| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`relative_airmass`, | CdTe, | | -| | clearsky index | poly-Si | [7]_ | -+---------------------------------------------------------+----------------------------+-----------------+-----------+ -| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | Any single | | -| | :term:`spectra` | junction | | -+---------------------------------------------------------+----------------------------+-----------------+-----------+ + ++-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ +| Model | Inputs | Default parameter availability | Reference | ++=====================================================+=============================+=========+=========+======+======+======+============+===========+ +| | | mono-Si | poly-Si | CdTe | CIGS | a-Si | perovskite | | ++=====================================================+=============================+=========+=========+======+======+======+============+===========+ +| :py:func:`Caballero ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | +| +-----------------------------+---------+---------+------+------+------+------------+ | +| |:term:`precipitable_water`, | | | | | | | [2]_ | +| +-----------------------------+---------+---------+------+------+------+------------+ | +| | :term:`aod` | | | | | | | | ++-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ +| :py:func:`First Solar ` | :term:`airmass_absolute`, | | ✔ | ✔ | | | | | +| +-----------------------------+---------+---------+------+------+------+------------+ [3]_ | +| | :term:`precipitable_water` | | | | | | | | ++-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ +| :py:func:`JRC ` | :term:`airmass_relative`, | | ✔ | ✔ | | | | | +| +-----------------------------+---------+---------+------+------+------+------------+ [4]_ | +| | :term:`clearsky_index` | | | | | | | | ++-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ +| :py:func:`PVSPEC ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | | | +| +-----------------------------+---------+---------+------+------+------+------------+ [5]_ | +| | :term:`clearsky_index` | | | | | | | | ++-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ +| :py:func:`SAPM ` | :term:`airmass_absolute` | | | | | | | [6]_ | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+------------+ + + ++-----------------------------------------------------+---------------------------------------------------------------------------------+-----------------------------------------------------+------------------+ +| | Inputs | Default parameters for tech | | +| Model +------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+ Reference & year | +| | airmass_relative | airmass_absolute | precipitable_water | clearsky_index | aod | a-Si | mono-Si | poly-Si | CdTe | CIGS | perovskite | | ++=====================================================+==================+==================+====================+================+=====+======+=========+=========+======+======+============+==================+ +| :py:func:`Caballero ` | | ✓ | ✓ | | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | [2]_, 2018 | ++-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+ +| :py:func:`First Solar ` | | ✓ | ✓ | | | | | ✓ | ✓ | | | [3]_, 2016 | ++-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+ +| :py:func:`JRC ` | ✓ | | | ✓ | | | | ✓ | ✓ | | | [4]_, 2008 | ++-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+ +| :py:func:`PVSPEC ` | | ✓ | | ✓ | | ✓ | ✓ | ✓ | ✓ | | | [5]_, 2020 | ++-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+ +| :py:func:`SAPM ` | | ✓ | | | | | | ✓ | ✓ | | | [6]_, 2004 | ++-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+ + + ++--------------------------------------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| Model | :py:func:`Caballero ` | :py:func:`First Solar ` | :py:func:`JRC ` | :py:func:`PVSPEC ` | :py:func:`SAPM ` | ++-----------------------------+--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | airmass_relative | | | ✓ | | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | airmass_absolute | ✓ | ✓ | | ✓ | ✓ | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| Inputs | precipitable_water | ✓ | ✓ | | | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | clearsky_index | | | ✓ | ✓ | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | aod | ✓ | | | | | ++-----------------------------+--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | a-Si | ✓ | | | ✓ | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | mono-Si | ✓ | | | ✓ | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | poly-Si | ✓ | ✓ | ✓ | ✓ | | +| Default parameters for tech +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | CdTe | ✓ | ✓ | ✓ | ✓ | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | CIGS | ✓ | | | | | +| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| | perovskite | ✓ | | | | | ++-----------------------------+--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ +| Reference & year | [2]_, 2018 | [3]_, 2016 | [4]_, 2008 | [5]_, 2020 | [6]_, 2004 | ++--------------------------------------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+ References @@ -77,17 +125,17 @@ References Depth and Precipitable Water for PV Performance Modeling," IEEE Journal of Photovoltaics, vol. 8, no. 2, pp. 552–558, Mar. 2018. :doi:`10.1109/JPHOTOV.2017.2787019` -.. [4] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module - Performance Based on Air Mass and Precipitable Water," 2016 IEEE 43rd - Photovoltaic Specialists Conference (PVSC), Portland, OR, USA, 2016, - pp. 3696-3699. :doi:`10.1109/PVSC.2016.7749836` -.. [5] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array - Performance Model, Sandia National Laboratories, Albuquerque, NM, USA, - Tech. Rep. SAND2004-3535, Aug. 2004. :doi:`10.2172/919131` -.. [6] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the +.. [4] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the PVSPEC Model of Photovoltaic Spectral Mismatch Factor," in Proc. 2020 IEEE 47th Photovoltaic Specialists Conference (PVSC), Calgary, AB, Canada, 2020, pp. 1–6. :doi:`10.1109/PVSC45281.2020.9300932` +.. [5] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array + Performance Model, Sandia National Laboratories, Albuquerque, NM, USA, + Tech. Rep. SAND2004-3535, Aug. 2004. :doi:`10.2172/919131` +.. [6] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module + Performance Based on Air Mass and Precipitable Water," 2016 IEEE 43rd + Photovoltaic Specialists Conference (PVSC), Portland, OR, USA, 2016, + pp. 3696-3699. :doi:`10.1109/PVSC.2016.7749836` .. [7] H. Thomas, S. Tony, and D. Ewan, “A Simple Model for Estimating the Influence of Spectrum Variations on PV Performance,” pp. 3385–3389, Nov. 2009, :doi:`10.4229/24THEUPVSEC2009-4AV.3.27` From 5da15817dcf9c67dfc7c74f2bb7f37c228cd0e7a Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 2 Jun 2025 15:52:58 -0600 Subject: [PATCH 25/27] fix table 1 formatting --- docs/sphinx/source/user_guide/modeling_topics/spectrum.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index 21c1a025f5..ac05385c61 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -39,7 +39,7 @@ of commerical module products. +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | Model | Inputs | Default parameter availability | Reference | -+=====================================================+=============================+=========+=========+======+======+======+============+===========+ ++ + +---------+---------+------+------+------+------------+ + | | | mono-Si | poly-Si | CdTe | CIGS | a-Si | perovskite | | +=====================================================+=============================+=========+=========+======+======+======+============+===========+ | :py:func:`Caballero ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | @@ -61,7 +61,7 @@ of commerical module products. | | :term:`clearsky_index` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`SAPM ` | :term:`airmass_absolute` | | | | | | | [6]_ | ------------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+------------+ ++-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ +-----------------------------------------------------+---------------------------------------------------------------------------------+-----------------------------------------------------+------------------+ From 0d49a8417994309977dd2877b0152bcd803b8377 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 2 Jun 2025 16:11:51 -0600 Subject: [PATCH 26/27] un-split rows with ticks --- .../source/user_guide/modeling_topics/spectrum.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index ac05385c61..9926e7b72a 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -43,21 +43,21 @@ of commerical module products. | | | mono-Si | poly-Si | CdTe | CIGS | a-Si | perovskite | | +=====================================================+=============================+=========+=========+======+======+======+============+===========+ | :py:func:`Caballero ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | -| +-----------------------------+---------+---------+------+------+------+------------+ | +| +-----------------------------| | | | | | | | | |:term:`precipitable_water`, | | | | | | | [2]_ | -| +-----------------------------+---------+---------+------+------+------+------------+ | +| +-----------------------------| | | | | | | | | | :term:`aod` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`First Solar ` | :term:`airmass_absolute`, | | ✔ | ✔ | | | | | -| +-----------------------------+---------+---------+------+------+------+------------+ [3]_ | +| +-----------------------------| | | | | | | [3]_ | | | :term:`precipitable_water` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`JRC ` | :term:`airmass_relative`, | | ✔ | ✔ | | | | | -| +-----------------------------+---------+---------+------+------+------+------------+ [4]_ | +| +-----------------------------| | | | | | + [4]_ | | | :term:`clearsky_index` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`PVSPEC ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | | | -| +-----------------------------+---------+---------+------+------+------+------------+ [5]_ | +| +-----------------------------| | | | | | | [5]_ | | | :term:`clearsky_index` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`SAPM ` | :term:`airmass_absolute` | | | | | | | [6]_ | From f58d43ac907ea3a1c53e6ca078f931c045b5b8c6 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Mon, 2 Jun 2025 16:24:52 -0600 Subject: [PATCH 27/27] Update spectrum.rst --- .../source/user_guide/modeling_topics/spectrum.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst index 9926e7b72a..62d544e81e 100644 --- a/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst +++ b/docs/sphinx/source/user_guide/modeling_topics/spectrum.rst @@ -43,21 +43,21 @@ of commerical module products. | | | mono-Si | poly-Si | CdTe | CIGS | a-Si | perovskite | | +=====================================================+=============================+=========+=========+======+======+======+============+===========+ | :py:func:`Caballero ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | -| +-----------------------------| | | | | | | | +| +-----------------------------+ | | | | | | | | |:term:`precipitable_water`, | | | | | | | [2]_ | -| +-----------------------------| | | | | | | | +| +-----------------------------+ | | | | | | | | | :term:`aod` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`First Solar ` | :term:`airmass_absolute`, | | ✔ | ✔ | | | | | -| +-----------------------------| | | | | | | [3]_ | +| +-----------------------------+ | | | | | | [3]_ | | | :term:`precipitable_water` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`JRC ` | :term:`airmass_relative`, | | ✔ | ✔ | | | | | -| +-----------------------------| | | | | | + [4]_ | +| +-----------------------------+ | | | | | + [4]_ | | | :term:`clearsky_index` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`PVSPEC ` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | | | -| +-----------------------------| | | | | | | [5]_ | +| +-----------------------------+ | | | | | | [5]_ | | | :term:`clearsky_index` | | | | | | | | +-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+ | :py:func:`SAPM ` | :term:`airmass_absolute` | | | | | | | [6]_ |