[lukelowry]

Description

First of three stacked PRs that add the EMT model family. This one adds the core classes, the bus, an impedance load, and the VectorFit operator.

Proposed changes

• Add EMT::Component and EMT::SystemModel, following the OPF design.
• Linear models compute their Jacobian once with dependency tracking.
• Read case and state keys by enum name with Utilities::enumKey, moved from OPF. Unknown keys throw.
• Set absolute tolerances per model from the bus kv and the system va_base.
• Add Bus, LoadZ, VectorFit, the case and state parsers, monitors, and INPUT_FORMAT.md.
• Add Testing::jacobianMatchesResidual and unit tests.

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.

Further comments

None.

[read-the-docs-community]

Documentation build overview

📚 GridKit | 🛠️ Build #35823621 | 📁 Comparing dde4bf4 against latest (c878731)

  🔍 Preview build  

138 files changed · + 89 added · ± 48 modified · - 1 deleted

+ Added

• api/reference/classAnalysisManager_1_1Sundials_1_1Partitioned.html
• api/reference/classAnalysisManager_1_1Sundials_1_1PartitionedException.html
• api/reference/classGridKit_1_1EMT_1_1Bus.html
• api/reference/classGridKit_1_1EMT_1_1Component.html
• api/reference/classGridKit_1_1EMT_1_1LoadZ.html
• api/reference/classGridKit_1_1EMT_1_1Monitor.html
• api/reference/classGridKit_1_1EMT_1_1SystemModel.html
• api/reference/classGridKit_1_1EMT_1_1VectorFit.html
• api/reference/classGridKit_1_1PowerElectronics_1_1BusLinePartitionInterface.html
• api/reference/classGridKit_1_1PowerElectronics_1_1PartitionInterface.html
• and 79 more...

± Modified

• genindex.html
• development/CHANGELOG.html
• api/reference/classAnalysisManager_1_1DynamicSolver.html
• api/reference/classGridKit_1_1Model_1_1Evaluator.html
• api/reference/classGridKit_1_1Model_1_1VariableMonitorBase.html
• api/reference/classGridKit_1_1PowerElectronics_1_1Component.html
• api/reference/classGridKit_1_1PowerElectronics_1_1SystemModel.html
• api/reference/dir_GridKit_Model.html
• api/reference/dir_GridKit_Model_PowerElectronics.html
• api/reference/dir_GridKit_Solver_Dynamic.html
• and 38 more...

- Deleted

• api/reference/function_namespaceGridKit_1_1OptimalPowerFlow_1a42921efa9f001ab59856db1a8881de3b.html

[pelesh]

This is awesome work!

Before we review, please document all *Impl.hpp files with Doxygen comments per developer guidelines. A little more verbose explanations what each method does together with invariants, pre- and post-conditionds, variable definitions, etc., is needed in a PR of this complexity.

[pelesh]

• Set absolute tolerances per model from the bus kv and the system va_base.

Fantastic!