Add guidance about temperature modeling to User Guide #2591
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
cwhanse
reviewed
Nov 4, 2025
Member
|
One thing that could be added is the parameter conversion from one model to another. Please leave this open for a few weeks as I'd like to comment more. |
Co-authored-by: Cliff Hansen <[email protected]>
RDaxini
reviewed
Nov 4, 2025
Member
|
Could consider listing |
Co-authored-by: RDaxini <[email protected]>
…r/pvlib-python into userguide-temperature
Member
|
This PR has been open for a few weeks now. I suggest we merge it on Monday the 7th if there are no objections. |
cwhanse
approved these changes
Dec 1, 2025
adriesse
reviewed
Dec 2, 2025
| Temperature models predict one of two quantities: | ||
|
|
||
| - *module temperature*: the temperature as measured at the back surface | ||
| of a PV module. Easy to measure, but usually less |
Member
There was a problem hiding this comment.
Suggested change
| of a PV module. Easy to measure, but usually less | |
| of a PV module. Easy to measure, but usually marginally less |
| irradiance, ambient temperature, and wind speed. Each model also takes | ||
| a set of parameter values that represent how a PV module responds to | ||
| those inputs. Parameter values generally depend on both the PV | ||
| module technologies and the mounting conditions of the module. |
Member
There was a problem hiding this comment.
Suggested change
| module technologies and the mounting conditions of the module. | |
| module technologies, the mounting conditions of the module | |
| and on any weather parameters that are not included in the model. |
| those inputs. Parameter values generally depend on both the PV | ||
| module technologies and the mounting conditions of the module. | ||
|
|
||
| Another way to classify temperature models is whether they account for |
Member
There was a problem hiding this comment.
Suggested change
| Another way to classify temperature models is whether they account for | |
| Another aspect of temperature models is whether they account for |
Comment on lines
+75
to
+77
| - :py:func:`~pvlib.temperature.generic_linear`: a generic linear model form, | ||
| equivalent to several conventional temperature models. | ||
|
|
Member
There was a problem hiding this comment.
I think this one could go in the table.
| and several additional sets of temperature model parameter values are | ||
| available in :py:data:`pvlib.temperature.TEMPERATURE_MODEL_PARAMETERS`. | ||
| However, these generic values may not be suitable for all modules and mounting | ||
| configurations. |
Member
There was a problem hiding this comment.
Suggested change
| configurations. | |
| configurations. It should be noted that using the default parameter values for each | |
| model generally leads to different modules temperature predictions. This alone | |
| does not mean one model is better than another; it's just evidence that the measurements | |
| used to derive the default parameter values were taken on different PV systems in different | |
| locations under different conditions. | |
| configurations. | ||
|
|
||
| Module-specific values can be obtained via testing, for example following | ||
| the IEC 61853-2 standard. |
Member
There was a problem hiding this comment.
Suggested change
| the IEC 61853-2 standard. | |
| the IEC 61853-2 standard for the Faiman model; however, such values still do not capture | |
| the dependency of temperature on system design and other variables. |
Comment on lines
+91
to
+93
| Parameter values for one model (e.g. ``u0``, ``u1`` for :py:func:`~pvlib.temperature.faiman`) | ||
| can be converted to another model (e.g. ``u_c``, ``u_v`` for :py:func:`~pvlib.temperature.pvsyst_cell`) | ||
| using :py:class:`~pvlib.temperature.GenericLinearModel`. |
Member
There was a problem hiding this comment.
I would move this to before the preceding paragraph
| can be converted to another model (e.g. ``u_c``, ``u_v`` for :py:func:`~pvlib.temperature.pvsyst_cell`) | ||
| using :py:class:`~pvlib.temperature.GenericLinearModel`. | ||
|
|
||
| Currently, pvlib provides no functionality for fitting parameter values |
Member
There was a problem hiding this comment.
You could consider including references to:
- The sandia data set for temperature model fitting, and it's accompanying notebook
- My paper on model fitting from last years PVSEC.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
[ ] Closes #xxxx[ ] Tests added[ ] Updates entries indocs/sphinx/source/referencefor API changes.docs/sphinx/source/whatsnewfor all changes. Includes link to the GitHub Issue with:issue:`num`or this Pull Request with:pull:`num`. Includes contributor name and/or GitHub username (link with:ghuser:`user`).[ ] New code is fully documented. Includes numpydoc compliant docstrings, examples, and comments where necessary.remote-data) and Milestone are assigned to the Pull Request and linked Issue.Continuing in a broader thrust of developing our user guide section. Previously:
See also:
Docs build: https://pvlib-python--2591.org.readthedocs.build/en/2591/user_guide/modeling_topics/temperature.html