Skip to content

Commit 324f134

Browse files
RDaxiniRDaxini
committed
Update spectrum.rst
1 parent eadf734 commit 324f134

1 file changed

Lines changed: 83 additions & 35 deletions

File tree

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

Lines changed: 83 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
.. _spectrum_user_guide:
2+
.. currentmodule:: pvlib.spectrum
3+
24

35
Spectrum
46
========
@@ -13,6 +15,7 @@ This user guide page summarizes some of pvlib-python's spectrum-related
1315
capabilities, starting with a summary of spectral mismatch estimation models
1416
available in pvlib-python.
1517

18+
1619
Spectral mismatch models
1720
------------------------
1821

@@ -33,33 +36,78 @@ technologies, the Sandia Array Performance Model (SAPM) and spectral mismatch
3336
calculation are not specific to cell type; the former is validated for a range
3437
of commerical module products.
3538

36-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
37-
| Model | Inputs | Cell technology | Reference |
38-
+=========================================================+============================+=================+===========+
39-
| :py:func:`~pvlib.spectrum.spectral_factor_caballero` | :term:`absolute_airmass`, | CdTe, | |
40-
| | :term:`precipitable_water`,| mono-Si, | |
41-
| | aerosol optical depth | poly-Si, | [3]_ |
42-
| | | aSi, | |
43-
| | | CIGS, | |
44-
| | | Perovskite | |
45-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
46-
| :py:func:`~pvlib.spectrum.spectral_factor_firstsolar` | :term:`absolute_airmass`, | CdTe, | |
47-
| | :term:`precipitable_water` | poly-Si | [4]_ |
48-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
49-
| :py:func:`~pvlib.spectrum.spectral_factor_sapm` | :term:`absolute_airmass` | Multiple | [5]_ |
50-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
51-
| :py:func:`~pvlib.spectrum.spectral_factor_pvspec` | :term:`absolute_airmass`, | CdTe, | |
52-
| | clearsky index | poly-Si, | |
53-
| | | mono-Si, | |
54-
| | | CIGS, | [6]_ |
55-
| | | aSi | |
56-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
57-
| :py:func:`~pvlib.spectrum.spectral_factor_jrc` | :term:`relative_airmass`, | CdTe, | |
58-
| | clearsky index | poly-Si | [7]_ |
59-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
60-
| :py:func:`~pvlib.spectrum.calc_spectral_mismatch_field` | spectral response, | Any single | |
61-
| | :term:`spectra` | junction | |
62-
+---------------------------------------------------------+----------------------------+-----------------+-----------+
39+
40+
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
41+
| Model | Inputs | Default parameter availability | Reference |
42+
+=====================================================+=============================+=========+=========+======+======+======+============+===========+
43+
| | | mono-Si | poly-Si | CdTe | CIGS | a-Si | perovskite | |
44+
+=====================================================+=============================+=========+=========+======+======+======+============+===========+
45+
| :py:func:`Caballero <spectral_factor_caballero>` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | |
46+
| +-----------------------------+---------+---------+------+------+------+------------+ |
47+
| |:term:`precipitable_water`, | | | | | | | [2]_ |
48+
| +-----------------------------+---------+---------+------+------+------+------------+ |
49+
| | :term:`aod` | | | | | | | |
50+
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
51+
| :py:func:`First Solar <spectral_factor_firstsolar>` | :term:`airmass_absolute`, | | ✔ | ✔ | | | | |
52+
| +-----------------------------+---------+---------+------+------+------+------------+ [3]_ |
53+
| | :term:`precipitable_water` | | | | | | | |
54+
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
55+
| :py:func:`JRC <spectral_factor_jrc>` | :term:`airmass_relative`, | | ✔ | ✔ | | | | |
56+
| +-----------------------------+---------+---------+------+------+------+------------+ [4]_ |
57+
| | :term:`clearsky_index` | | | | | | | |
58+
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
59+
| :py:func:`PVSPEC <spectral_factor_pvspec>` | :term:`airmass_absolute`, | ✔ | ✔ | ✔ | ✔ | ✔ | | |
60+
| +-----------------------------+---------+---------+------+------+------+------------+ [5]_ |
61+
| | :term:`clearsky_index` | | | | | | | |
62+
+-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+-----------+
63+
| :py:func:`SAPM <spectral_factor_sapm>` | :term:`airmass_absolute` | | | | | | | [6]_ |
64+
-----------------------------------------------------+-----------------------------+---------+---------+------+------+------+------------+------------+
65+
66+
67+
+-----------------------------------------------------+---------------------------------------------------------------------------------+-----------------------------------------------------+------------------+
68+
| | Inputs | Default parameters for tech | |
69+
| Model +------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+ Reference & year |
70+
| | airmass_relative | airmass_absolute | precipitable_water | clearsky_index | aod | a-Si | mono-Si | poly-Si | CdTe | CIGS | perovskite | |
71+
+=====================================================+==================+==================+====================+================+=====+======+=========+=========+======+======+============+==================+
72+
| :py:func:`Caballero <spectral_factor_caballero>` | | ✓ | ✓ | | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | [2]_, 2018 |
73+
+-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+
74+
| :py:func:`First Solar <spectral_factor_firstsolar>` | | ✓ | ✓ | | | | | ✓ | ✓ | | | [3]_, 2016 |
75+
+-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+
76+
| :py:func:`JRC <spectral_factor_jrc>` | ✓ | | | ✓ | | | | ✓ | ✓ | | | [4]_, 2008 |
77+
+-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+
78+
| :py:func:`PVSPEC <spectral_factor_pvspec>` | | ✓ | | ✓ | | ✓ | ✓ | ✓ | ✓ | | | [5]_, 2020 |
79+
+-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+
80+
| :py:func:`SAPM <spectral_factor_sapm>` | | ✓ | | | | | | ✓ | ✓ | | | [6]_, 2004 |
81+
+-----------------------------------------------------+------------------+------------------+--------------------+----------------+-----+------+---------+---------+------+------+------------+------------------+
82+
83+
84+
+--------------------------------------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
85+
| Model | :py:func:`Caballero <spectral_factor_caballero>` | :py:func:`First Solar <spectral_factor_firstsolar>` | :py:func:`JRC <spectral_factor_jrc>` | :py:func:`PVSPEC <spectral_factor_pvspec>` | :py:func:`SAPM <spectral_factor_sapm>` |
86+
+-----------------------------+--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
87+
| | airmass_relative | | | ✓ | | |
88+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
89+
| | airmass_absolute | ✓ | ✓ | | ✓ | ✓ |
90+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
91+
| Inputs | precipitable_water | ✓ | ✓ | | | |
92+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
93+
| | clearsky_index | | | ✓ | ✓ | |
94+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
95+
| | aod | ✓ | | | | |
96+
+-----------------------------+--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
97+
| | a-Si | ✓ | | | ✓ | |
98+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
99+
| | mono-Si | ✓ | | | ✓ | |
100+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
101+
| | poly-Si | ✓ | ✓ | ✓ | ✓ | |
102+
| Default parameters for tech +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
103+
| | CdTe | ✓ | ✓ | ✓ | ✓ | |
104+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
105+
| | CIGS | ✓ | | | | |
106+
| +--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
107+
| | perovskite | ✓ | | | | |
108+
+-----------------------------+--------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
109+
| Reference & year | [2]_, 2018 | [3]_, 2016 | [4]_, 2008 | [5]_, 2020 | [6]_, 2004 |
110+
+--------------------------------------------------+--------------------------------------------------+-----------------------------------------------------+--------------------------------------+--------------------------------------------+----------------------------------------+
63111

64112

65113
References
@@ -77,17 +125,17 @@ References
77125
Depth and Precipitable Water for PV Performance Modeling," IEEE Journal
78126
of Photovoltaics, vol. 8, no. 2, pp. 552–558, Mar. 2018.
79127
:doi:`10.1109/JPHOTOV.2017.2787019`
80-
.. [4] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module
81-
Performance Based on Air Mass and Precipitable Water," 2016 IEEE 43rd
82-
Photovoltaic Specialists Conference (PVSC), Portland, OR, USA, 2016,
83-
pp. 3696-3699. :doi:`10.1109/PVSC.2016.7749836`
84-
.. [5] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array
85-
Performance Model, Sandia National Laboratories, Albuquerque, NM, USA,
86-
Tech. Rep. SAND2004-3535, Aug. 2004. :doi:`10.2172/919131`
87-
.. [6] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the
128+
.. [4] S. Pelland, J. Remund, and J. Kleissl, "Development and Testing of the
88129
PVSPEC Model of Photovoltaic Spectral Mismatch Factor," in Proc. 2020
89130
IEEE 47th Photovoltaic Specialists Conference (PVSC), Calgary, AB,
90131
Canada, 2020, pp. 1–6. :doi:`10.1109/PVSC45281.2020.9300932`
132+
.. [5] D. L. King, W. E. Boyson, and J. A. Kratochvil, Photovoltaic Array
133+
Performance Model, Sandia National Laboratories, Albuquerque, NM, USA,
134+
Tech. Rep. SAND2004-3535, Aug. 2004. :doi:`10.2172/919131`
135+
.. [6] M. Lee and A. Panchula, "Spectral Correction for Photovoltaic Module
136+
Performance Based on Air Mass and Precipitable Water," 2016 IEEE 43rd
137+
Photovoltaic Specialists Conference (PVSC), Portland, OR, USA, 2016,
138+
pp. 3696-3699. :doi:`10.1109/PVSC.2016.7749836`
91139
.. [7] H. Thomas, S. Tony, and D. Ewan, “A Simple Model for Estimating the
92140
Influence of Spectrum Variations on PV Performance,” pp. 3385–3389, Nov.
93141
2009, :doi:`10.4229/24THEUPVSEC2009-4AV.3.27`

0 commit comments

Comments
 (0)