Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add spectral mismatch model comparison table #2353

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
Prev Previous commit
Next Next commit
rename, fix gallery example link, update cell tech
RDaxini committed Jan 28, 2025

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
commit 0be2e469c53b03833550149c2e2065f0c3dbe19d
47 changes: 22 additions & 25 deletions docs/sphinx/source/user_guide/model_comparison.rst
Original file line number Diff line number Diff line change
@@ -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
----------