From 2b3d02e656f057e68f175f3096f38e66a15fb217 Mon Sep 17 00:00:00 2001 From: RDaxini Date: Fri, 10 Jan 2025 11:55:30 -0700 Subject: [PATCH 01/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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/12] 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 ------------------------