[lukelowry]

Description

Adds a state_file solver option that sets initial bus voltages from a .state.json file, following #514 and #643.

Proposed changes

• applyState sets bus Vr/Vi from the state file by case bus number.
• Optional state_file in the solver file, used by the Hawaii validation.
• Test: CaseFormatTests::stateParse.

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

Device entries and removal of the case init follow in later PRs.

[lukelowry]

@nkoukpaizan @pelesh This is the highest value next migration step

[read-the-docs-community]

Documentation build overview

📚 GridKit | 🛠️ Build #35820065 | 📁 Comparing 55c08af against latest (2eeed28)

  🔍 Preview build  

12 files changed · + 2 added · ± 10 modified

+ Added

• api/reference/function_namespaceGridKit_1_1PhasorDynamics_1a7111cc5024ff9f10a96d4253cb0c98bf.html
• api/reference/function_namespaceGridKit_1_1PhasorDynamics_1aa6e8866c12adfd46197c12b940b82c16.html

± Modified

• genindex.html
• development/CHANGELOG.html
• api/reference/file_GridKit_AutomaticDifferentiation_DependencyTracking_VariableOperators.hpp.html
• api/reference/file_GridKit_Model_OptimalPowerFlow_SystemModelDataJSONParser.hpp.html
• api/reference/file_GridKit_Model_PhasorDynamics_SystemModelData.hpp.html
• api/reference/file_GridKit_Model_PhasorDynamics_SystemModelDataJSONParser.hpp.html
• api/reference/file_GridKit_Testing_Testing.hpp.html
• api/reference/namespace_GridKit__DependencyTracking.html
• api/reference/namespace_GridKit__PhasorDynamics.html
• application/PhasorDynamics/README.html

[nkoukpaizan]

Looks good!

I'll merge once rebased and CHANGELOG conflict is resolved and CI passes. Expect CI to fail for some time because of a GitHub actions issue.

[nkoukpaizan]

[Minor, thoughts for future PRs] Is there an acceptable situation where this condition will not be met? Perhaps we need some validation between the state and case files. A mismatch would be silent here.

[lukelowry]

I agree, I adjust it so it requires every bus voltage to be specified.

Should be ready to merge