Skip to content

Add is_backtracking and is_at_limit outputs to singleaxis#2709

Open
r0hansaxena wants to merge 1 commit intopvlib:mainfrom
r0hansaxena:add-tracking-state-booleans
Open

Add is_backtracking and is_at_limit outputs to singleaxis#2709
r0hansaxena wants to merge 1 commit intopvlib:mainfrom
r0hansaxena:add-tracking-state-booleans

Conversation

@r0hansaxena
Copy link
Contributor

  • Closes Add “is it true tracking” Boolean output to singleaxis #2672
  • I am familiar with the contributing guidelines
  • I attest that all AI-generated material has been vetted for accuracy and is in compliance with the pvlib license
  • Tests added
  • Updates entries in docs/sphinx/source/reference 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 (including remote-data) and Milestone are assigned to the Pull Request and linked Issue.

Add two boolean output columns to pvlib.tracking.singleaxis:

  • is_backtracking: True when tracker is in backtracking mode
  • is_at_limit: True when rotation angle is clipped to max/min

As discussed in #2672, this implements the simpler suggestion of adding two boolean flags (is_backtracking and is_at_limit) indicating the physical state of the tracker, rather than a full enumerated state dictionary.

  • is_backtracking is determined by whether the tracker is actively avoiding row-to-row shade (temp < 1 when backtracking is enabled).
  • is_at_limit is determined by comparing the clipped tracker_theta to its unclipped ideal angle.
    Existing tests were updated to gracefully handle the extra columns without breaking, and two new tests were added specifically to cover the new boolean flags.

Add two boolean output columns to pvlib.tracking.singleaxis:
- is_backtracking: True when tracker is in backtracking mode
- is_at_limit: True when rotation angle is clipped to max/min

Closes pvlib#2672
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add “is it true tracking” Boolean output to singleaxis

1 participant