@@ -25,6 +25,10 @@ a set of parameter values that represent how a PV module responds to
2525those inputs. Parameter values generally depend on both the PV
2626module technologies, the mounting configuration of the module,
2727and on any weather parameters that are not included in the model.
28+ Note that, despite models conventionally being associated with either
29+ cell or module temperature, it is actually the parameter values that determine
30+ which of the two temperatures are predicted, as they will produce the same
31+ type of temperature from which they were originally derived.
2832
2933Another aspect of temperature models is whether they account for
3034the thermal inertia of a PV module. Temperature models are either:
@@ -41,40 +45,39 @@ photoconversion efficiency and radiative cooling.
4145The temperature models currently available in pvlib are summarized in the
4246following table:
4347
44- +-------------------------------------------+--------+------------+---------------------------------------------------------------------------+
45- | Model | Type | Transient? | Inputs |
46- | | | +----------------+---------------------+------------+-----------------------+
47- | | | | POA irradiance | Ambient temperature | Wind speed | Downwelling IR [#f1 ]_ |
48- +===========================================+========+============+================+=====================+============+=======================+
49- | :py:func: `~pvlib.temperature.faiman ` | either | | ✓ | ✓ | ✓ | |
50- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
51- | :py:func: `~pvlib.temperature.faiman_rad ` | either | | ✓ | ✓ | ✓ | ✓ |
52- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
53- | :py:func: `~pvlib.temperature.fuentes ` | cell | ✓ | ✓ | ✓ | ✓ | |
54- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
55- | :py:func: `~pvlib.temperature.noct_sam ` | cell | | ✓ | ✓ | ✓ | |
56- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
57- | :py:func: `~pvlib.temperature.pvsyst_cell ` | cell | | ✓ | ✓ | ✓ | |
58- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
59- | :py:func: `~pvlib.temperature.ross ` | cell | | ✓ | ✓ | | |
60- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
61- | :py:func: `~pvlib.temperature.sapm_cell ` | cell | | ✓ | ✓ | ✓ | |
62- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
63- | :py:func: `~pvlib.temperature.sapm_module ` | module | | ✓ | ✓ | ✓ | |
64- +-------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
48+ +----------------------------------------------+--------+------------+---------------------------------------------------------------------------+
49+ | Model | Type | Transient? | Inputs |
50+ | | | +----------------+---------------------+------------+-----------------------+
51+ | | | | POA irradiance | Ambient temperature | Wind speed | Downwelling IR [#f1 ]_ |
52+ +==============================================+========+============+================+=====================+============+=======================+
53+ | :py:func: `~pvlib.temperature.faiman ` | either | | ✓ | ✓ | ✓ | |
54+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
55+ | :py:func: `~pvlib.temperature.faiman_rad ` | either | | ✓ | ✓ | ✓ | ✓ |
56+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
57+ | :py:func: `~pvlib.temperature.fuentes ` | either | ✓ | ✓ | ✓ | ✓ | |
58+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
59+ | :py:func: `~pvlib.temperature.generic_linear ` | cell | | ✓ | ✓ | ✓ | |
60+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
61+ | :py:func: `~pvlib.temperature.noct_sam ` | cell | | ✓ | ✓ | ✓ | |
62+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
63+ | :py:func: `~pvlib.temperature.pvsyst_cell ` | cell | | ✓ | ✓ | ✓ | |
64+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
65+ | :py:func: `~pvlib.temperature.ross ` | cell | | ✓ | ✓ | | |
66+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
67+ | :py:func: `~pvlib.temperature.sapm_cell ` | cell | | ✓ | ✓ | ✓ | |
68+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
69+ | :py:func: `~pvlib.temperature.sapm_module ` | module | | ✓ | ✓ | ✓ | |
70+ +----------------------------------------------+--------+------------+----------------+---------------------+------------+-----------------------+
6571
6672.. [#f1 ] Downwelling infrared radiation.
6773
68-
6974 In addition to the core models above, pvlib provides several other functions
7075for temperature modeling:
7176
7277- :py:func: `~pvlib.temperature.prilliman `: an "add-on" model that reprocesses
7378 the output of a steady-state model to apply transient effects.
7479- :py:func: `~pvlib.temperature.sapm_cell_from_module `: a model for
7580 estimating cell temperature from module temperature.
76- - :py:func: `~pvlib.temperature.generic_linear `: a generic linear model form,
77- equivalent to several conventional temperature models.
7881
7982
8083Model parameters
@@ -90,14 +93,13 @@ does not mean one model is better than another; it's just evidence that the meas
9093used to derive the default parameter values were taken on different PV systems in different
9194locations under different conditions.
9295
96+ Parameter values for one model (e.g. ``u0 ``, ``u1 `` for :py:func: `~pvlib.temperature.faiman `)
97+ can be converted to another model (e.g. ``u_c ``, ``u_v `` for :py:func: `~pvlib.temperature.pvsyst_cell `)
98+ using :py:class: `~pvlib.temperature.GenericLinearModel `.
9399
94100Module-specific values can be obtained via testing, for example following
95101the IEC 61853-2 standard for the Faiman model; however, such values still do not capture
96102the dependency of temperature on system design and other variables.
97103
98- Parameter values for one model (e.g. ``u0 ``, ``u1 `` for :py:func: `~pvlib.temperature.faiman `)
99- can be converted to another model (e.g. ``u_c ``, ``u_v `` for :py:func: `~pvlib.temperature.pvsyst_cell `)
100- using :py:class: `~pvlib.temperature.GenericLinearModel `.
101-
102104Currently, pvlib provides no functionality for fitting parameter values
103105using measured temperature.
0 commit comments