Skip to content

Governor Documentation and Model#103

Closed
lukelowry wants to merge 145 commits into
developfrom
lukel/phasor_tgov1_dev
Closed

Governor Documentation and Model#103
lukelowry wants to merge 145 commits into
developfrom
lukel/phasor_tgov1_dev

Conversation

@lukelowry
Copy link
Copy Markdown
Collaborator

@lukelowry lukelowry commented May 7, 2025

Description

Documentation for the phasor dynamics governor (TGOV1) that will be implemented following this PR.

Proposed changes

Restructured folder to allow for many gov. types and added documentation for TGOV1

Further comments

There are piece-wise differential equations in this system. I wrote a short proposal on how to implement this to cooperate with the general solver. Please let me know if a bump function is sufficient or if the general solver can handle piece-wise definition (not to my knowledge).

Also there was a small latex issue in GENROU that I included in this PR.

Checklist

  • Governor Implementation
  • Proper CMake build configuration.
  • Documentation in a form of README file with model equations.
  • Example of usage.
  • All tests pass.
  • The new code follows GridKit™ style guidelines.
  • There are unit tests for the new code.
  • The feature branch is rebased with respect to the target branch.

@lukelowry lukelowry requested a review from abirchfield May 7, 2025 19:17
@pelesh pelesh added the documentation Improvements or additions to documentation label May 7, 2025
Copy link
Copy Markdown
Collaborator

@pelesh pelesh left a comment

Choose a reason for hiding this comment

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

Great work! It would be good to make some additional clarification and make sure equations match the signal flow diagram.

Comment thread src/Model/PhasorDynamics/Governor/TGOV1/README.md Outdated
Comment thread src/Model/PhasorDynamics/Governor/TGOV1/README.md Outdated
Comment thread src/Model/PhasorDynamics/Governor/TGOV1/README.md Outdated
Comment thread src/Model/PhasorDynamics/Governor/TGOV1/README.md Outdated
Comment thread src/Model/PhasorDynamics/Governor/TGOV1/README.md Outdated
Comment thread src/Model/PhasorDynamics/Governor/TGOV1/README.md Outdated
@lukelowry
Copy link
Copy Markdown
Collaborator Author

Comments addressed. Awaiting @abirchfield comments, especially in regards to clarifying units.

@lukelowry lukelowry changed the title Governor Documentation Governor Documentation and Model May 11, 2025
@lukelowry
Copy link
Copy Markdown
Collaborator Author

Untested implementation in recent commit, aligned with documentation.

lukelowry and others added 2 commits May 11, 2025 16:01
* size_quad() --> sizeQuadrature().

* Add missing overrides in IdaTests.

* Fix time assert with tolerance within a namespace.

* Use GridKit's isEqual in example2 time stamp assertion.

---------

Co-authored-by: nkoukpaizan <nkoukpaizan@users.noreply.github.com>
@lukelowry lukelowry deleted the lukel/phasor_tgov1_dev branch June 26, 2025 23:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation new model

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants