-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Rename eta_m and eta_m_ref to module_efficiency #1218
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
Conversation
|
@wholmgren ok to merge? |
pvlib/temperature.py
Outdated
|
|
||
| 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
| :math:`\left[ \frac{\text{W}/\text{m}^2}{\text{C}\ \left( \text{m/s} \right)} \right]` # noQA: E501 | ||
| 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.
wholmgren
left a comment
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.
| * ``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.rstfor 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`).Deprecates
eta_minpvlib.temperature.pvsyst_celland replaceseta_m_refinpvlib.temperature.noct_samwithmodule_efficiency.