Repository navigation
Add wind-dependent freestanding PVsyst temperature preset #2938
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
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -20,6 +20,7 @@ | |||||||||
| 'insulated_back_glass_polymer': {'a': -2.81, 'b': -.0455, 'deltaT': 0}, | ||||||||||
| }, | ||||||||||
| 'pvsyst': {'freestanding': {'u_c': 29.0, 'u_v': 0}, | ||||||||||
| 'freestanding_wind': {'u_c': 25.0, 'u_v': 1.2}, | ||||||||||
| 'insulated': {'u_c': 15.0, 'u_v': 0}, | ||||||||||
| 'semi_integrated': {'u_c': 20.0, 'u_v': 0}} | ||||||||||
| } | ||||||||||
|
|
@@ -342,8 +343,8 @@ def pvsyst_cell(poa_global, temp_air, wind_speed=1.0, u_c=29.0, u_v=0.0, | |||||||||
|
|
||||||||||
| wind_speed : numeric, default 1.0 | ||||||||||
| Wind speed in m/s measured at the same height for which the wind loss | ||||||||||
| factor was determined. The default value 1.0 m/s is the wind | ||||||||||
| speed at module height used to determine NOCT. [m/s] | ||||||||||
| factor was determined. See Notes for the ``freestanding_wind`` | ||||||||||
| parameter set. [m/s] | ||||||||||
|
|
||||||||||
| u_c : float, default 29.0 | ||||||||||
| Combined heat loss factor coefficient. The default value is | ||||||||||
|
|
@@ -388,15 +389,23 @@ def pvsyst_cell(poa_global, temp_air, wind_speed=1.0, u_c=29.0, u_v=0.0, | |||||||||
| factors provided represent the combined effect of convection, radiation and | ||||||||||
| conduction, and their values are experimentally determined. | ||||||||||
|
|
||||||||||
| +-----------------+---------------+---------------+ | ||||||||||
| | Mounting | :math:`U_{c}` | :math:`U_{v}` | | ||||||||||
| +=================+===============+===============+ | ||||||||||
| | freestanding | 29.0 | 0.0 | | ||||||||||
| +-----------------+---------------+---------------+ | ||||||||||
| | insulated | 15.0 | 0.0 | | ||||||||||
| +-----------------+---------------+---------------+ | ||||||||||
| | semi_integrated | 20.0 | 0.0 | | ||||||||||
| +-----------------+---------------+---------------+ | ||||||||||
| +-------------------+---------------+---------------+ | ||||||||||
| | Parameter set | :math:`U_{c}` | :math:`U_{v}` | | ||||||||||
| +===================+===============+===============+ | ||||||||||
| | freestanding | 29.0 | 0.0 | | ||||||||||
| +-------------------+---------------+---------------+ | ||||||||||
| | freestanding_wind | 25.0 | 1.2 | | ||||||||||
| +-------------------+---------------+---------------+ | ||||||||||
| | insulated | 15.0 | 0.0 | | ||||||||||
| +-------------------+---------------+---------------+ | ||||||||||
| | semi_integrated | 20.0 | 0.0 | | ||||||||||
| +-------------------+---------------+---------------+ | ||||||||||
|
|
||||||||||
| The ``freestanding_wind`` parameters are the PVUSA correlation described | ||||||||||
| in [3]_ for open-rack systems with wind speed data. Standard meteorological | ||||||||||
| wind speed is measured at 10 m above ground. The wind loss coefficient | ||||||||||
| must be appropriate for the measurement height; these coefficients are | ||||||||||
| not universal. Use coefficients fitted to the installation when available. | ||||||||||
|
|
||||||||||
| Mounting cases can be described in terms of air flow across and around the | ||||||||||
| rear-facing surface of the module: | ||||||||||
|
|
@@ -417,6 +426,11 @@ def pvsyst_cell(poa_global, temp_air, wind_speed=1.0, u_c=29.0, u_v=0.0, | |||||||||
| .. [2] Faiman, D. (2008). "Assessing the outdoor operating temperature of | ||||||||||
| photovoltaic modules." Progress in Photovoltaics 16(4): 307-315. | ||||||||||
|
|
||||||||||
| .. [3] PVsyst SA, "Heat transfer coefficients (U-values)," PVsyst | ||||||||||
| documentation. [Online]. Available: | ||||||||||
| https://www.pvsyst.com/help/project-design/array-and-system-losses/array-thermal-losses/u-value-measurement.html. | ||||||||||
| [Accessed: 8-Nov-2026]. | ||||||||||
|
|
||||||||||
|
Comment on lines
+429
to
+433
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
The new coefficients are already in [1]. I don't see the need to cite one more time the same content. You may update [1] accessed date.
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The new link looks like the modern version of [1]. Anyway, it seems like PVUSA needs to be referenced here also. |
||||||||||
| Examples | ||||||||||
| -------- | ||||||||||
| >>> from pvlib.temperature import pvsyst_cell, TEMPERATURE_MODEL_PARAMETERS | ||||||||||
|
|
||||||||||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Although true, this sounds a bit misleading. One can more easily change the wind speed from the measured height to the height of interest than fit data. At least mention
atmosphere.windspeed_powerlaw.Do not state
Use coefficients fitted to the installation when available.. That is true for all experimental models.There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
But it's more true for temperature models!!