[nkoukpaizan]

Description

This adds an integration test simulating the TwoArea case as two subsystems and verifying that the results match the

Proposed changes

• Added TwoAreaHierarchical.case.json with a README describing how it relates to cases/PhasorDynamics/TwoArea/README.md.
• Added the PhasorDynamicsIntegrationTwoAreaHierarchical integration test, comparing the flat and hierarchical systems at the initial (including residuals and Jacobians) and final (bus voltages and state vector) points. Both still use monolithic IDA to integrate, but differ in the model evaluation. Once we merge Add interface to partitioned DAE integrator #614, we can experiment with the partitioned integrator.
• Minor variable renaming in the tests to improve readability.

Checklist

• All tests pass.
• Code compiles cleanly with flags -Wall -Wpedantic -Wconversion -Wextra.
• The new code follows GridKit™ style guidelines.
• There are unit tests for the new code.
• The new code is documented.
• The feature branch is rebased with respect to the target branch.
• The CHANGELOG.md has been updated to reflect the changes. If this is a minor PR that is part of a larger fix already included in the file, state so.

Further comments

Writing the test showed that the TwoArea generators lose synchronism with no fault, so this PR also fixes the case data. @lukelowry, please check.

• Set Kf = 0.1 and Tf = 1.0 on all four IEEET1 exciters.
• Changed Vrmax from 0.0 to 3.0 on 3_1_ieeet1, to match the other three exciters.

[read-the-docs-community]

Documentation build overview

📚 GridKit | 🛠️ Build #35655573 | 📁 Comparing 42bd192 against latest (c878731)

  🔍 Preview build  

5 files changed · ± 5 modified

± Modified

• development/CHANGELOG.html
• api/reference/file_GridKit_Model_OptimalPowerFlow_SystemModelData.hpp.html
• api/reference/file_GridKit_Model_PhasorDynamics_SystemModelData.hpp.html
• api/reference/namespace_GridKit__PhasorDynamics.html
• cases/PhasorDynamics/TwoArea/README.html