-
Notifications
You must be signed in to change notification settings - Fork 1.1k
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
Rename eta_m and eta_m_ref to module_efficiency #1218
Conversation
@wholmgren ok to merge? |
pvlib/temperature.py
Outdated
@@ -285,7 +286,7 @@ def sapm_cell_from_module(module_temperature, poa_global, deltaT, | |||
|
|||
|
|||
def pvsyst_cell(poa_global, temp_air, wind_speed=1.0, u_c=29.0, u_v=0.0, | |||
eta_m=0.1, alpha_absorption=0.9): | |||
eta_m=0.1, module_efficiency=0.1, alpha_absorption=0.9): |
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.
eta_m=0.1, module_efficiency=0.1, alpha_absorption=0.9): | |
eta_m=None, module_efficiency=0.1, alpha_absorption=0.9): |
pvlib/temperature.py
Outdated
|
||
eta_m : numeric, default 0.1 | ||
eta_m : numeric, default 0.1 (deprecated, use module_efficiency instead) |
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.
eta_m : numeric, default 0.1 (deprecated, use module_efficiency instead) | |
eta_m : numeric, default None (deprecated, use module_efficiency instead) |
pvlib/temperature.py
Outdated
if not module_efficiency: | ||
module_efficiency = eta_m |
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.
This doesn't make much sense to me. To get here you'd have to explicitly set module_efficiency=None
. Maybe better to just override module_efficiency
with eta_m
if it's provided.
pvlib/temperature.py
Outdated
Module external efficiency as a fraction, i.e., | ||
:math:`DC\ power / (POA\ irradiance \times module\ area)`. | ||
Parameter :math:`\eta_{m}` in :eq:`pvsyst`. |
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.
remove this. pending resolution of comment below, add "If not None, warns of deprecation and overrides module_efficiency
"
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.
I agree with all your suggestions.
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.
minor doc suggestion otherwise ready to merge.
@@ -67,6 +67,10 @@ Deprecations | |||
* ``ModelChain.weather`` | |||
* ``ModelChain.times`` | |||
|
|||
* The ``eta_m`` parameter for :py:func:`~pvlib.temperature.pvsyst_cell` is | |||
replaced by the ``module_efficiency`` parameter. |
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.
replaced by the ``module_efficiency`` parameter. | |
replaced by the ``module_efficiency`` parameter. (:issue:`1188`, :pull:`1218`) |
Updates entries todocs/sphinx/source/api.rst
for API changes.docs/sphinx/source/whatsnew
for 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`
).Deprecates
eta_m
inpvlib.temperature.pvsyst_cell
and replaceseta_m_ref
inpvlib.temperature.noct_sam
withmodule_efficiency
.