Governor Documentation and Model

[lukelowry]

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.

[pelesh]

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

[lukelowry]

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

[lukelowry]

Untested implementation in recent commit, aligned with documentation.

[abirchfield]

Documentation needs to be updated to reflect structure in #127 and #128 .

I suggest documenting both piecewise and an initial smoothed approximation for the limits.

[abirchfield]

Also, name of model should be TGOV1 or Governor_TGOV1. TurbineGov could apply to other future governors and we want each to be unique.

[pelesh]

Also, name of model should be TGOV1 or Governor_TGOV1. TurbineGov could apply to other future governors and we want each to be unique.

Per developer guidelines class names should be upper camel case format, something like this: GovernorTgov1. Would that be acceptable to domain specialists?

We could also use just Tgov1 and put it in a Governor namespace. In that case one would reference the class as Governor::Tgov1.

CC @superwhiskers @nkoukpaizan @alexander-novo

[abirchfield]

GovernorTgov1 is ok.