Skip to content
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

Merged
merged 7 commits into from
May 7, 2021
Merged

Conversation

cwhanse
Copy link
Member

@cwhanse cwhanse commented May 6, 2021

  • Closes change eta_m to module_efficiency #1188
  • I am familiar with the contributing guidelines
  • Tests added
  • Updates entries to docs/sphinx/source/api.rst for API changes.
  • Adds description and name entries in the appropriate "what's new" file in 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`).
  • New code is fully documented. Includes numpydoc compliant docstrings, examples, and comments where necessary.
  • Pull request is nearly complete and ready for detailed review.
  • Maintainer: Appropriate GitHub Labels and Milestone are assigned to the Pull Request and linked Issue.

Deprecates eta_m in pvlib.temperature.pvsyst_cell and replaces eta_m_ref in pvlib.temperature.noct_sam with module_efficiency.

@cwhanse cwhanse added this to the 0.9.0 milestone May 7, 2021
@cwhanse
Copy link
Member Author

cwhanse commented May 7, 2021

@wholmgren ok to merge?

@cwhanse cwhanse mentioned this pull request May 7, 2021
24 tasks
@@ -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):
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
eta_m=0.1, module_efficiency=0.1, alpha_absorption=0.9):
eta_m=None, module_efficiency=0.1, alpha_absorption=0.9):


eta_m : numeric, default 0.1
eta_m : numeric, default 0.1 (deprecated, use module_efficiency instead)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
eta_m : numeric, default 0.1 (deprecated, use module_efficiency instead)
eta_m : numeric, default None (deprecated, use module_efficiency instead)

Comment on lines 382 to 383
if not module_efficiency:
module_efficiency = eta_m
Copy link
Member

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.

Comment on lines 320 to 322
Module external efficiency as a fraction, i.e.,
:math:`DC\ power / (POA\ irradiance \times module\ area)`.
Parameter :math:`\eta_{m}` in :eq:`pvsyst`.
Copy link
Member

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"

Copy link
Member Author

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.

Copy link
Member

@wholmgren wholmgren left a 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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
replaced by the ``module_efficiency`` parameter.
replaced by the ``module_efficiency`` parameter. (:issue:`1188`, :pull:`1218`)

@cwhanse cwhanse mentioned this pull request May 7, 2021
8 tasks
@wholmgren wholmgren merged commit 50dcc7f into pvlib:master May 7, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

change eta_m to module_efficiency
3 participants