[superwhiskers]

Description

this pull request implements the co-simulation interface in preparation for its implementation in the application

Proposed changes

as with the previous in this series, there's a small amount of diff noise here from breaking this out of the earlier monolithic commit which included formatting changes

• add client/server transport and message handling
• add co-simulation interface 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. If this is a minor PR that is part of a larger fix already included in the file, state so.

[read-the-docs-community]

Documentation build overview

📚 GridKit | 🛠️ Build #35624039 | 📁 Comparing 04d980c against latest (9963c0d)

  🔍 Preview build  

98 files changed · + 45 added · ± 53 modified

+ Added

• api/reference/classGridKit_1_1CoSim_1_1CoSim.html
• api/reference/classGridKit_1_1CoSim_1_1detail_1_1Channel.html
• api/reference/classGridKit_1_1CoSim_1_1detail_1_1PeerFailure.html
• api/reference/classGridKit_1_1CoSim_1_1detail_1_1Stopped.html
• api/reference/dir_GridKit_CoSim.html
• api/reference/enum_namespaceGridKit_1_1CoSim_1_1detail_1af7a12d7b8ccabbf033e2bd143e4d62d5.html
• api/reference/enum_namespaceGridKit_1_1CoSim_1a465bcffd863fd890a500f315bfcf174a.html
• api/reference/enum_namespaceGridKit_1_1CoSim_1a471cbc96a8875b14fc17021551280c85.html
• api/reference/enum_namespaceGridKit_1_1CoSim_1ad3d568e7efb1854aca2f446e37f9e67d.html
• api/reference/enum_namespaceGridKit_1_1PhasorDynamics_1_1Controller_1a66f8c7d54bb07fa22c0624fbcad99e27.html
• and 35 more...

± Modified

• genindex.html
• development/CHANGELOG.html
• api/reference/classAnalysisManager_1_1Sundials_1_1Kinsol.html
• api/reference/classAnalysisManager_1_1Sundials_1_1SundialsException.html
• api/reference/classGridKit_1_1PhasorDynamics_1_1BusSignalVoltageOut.html
• api/reference/classGridKit_1_1Utilities_1_1CliArgs.html
• api/reference/dir_GridKit.html
• api/reference/dir_GridKit_Solver.html
• api/reference/enum_namespaceGridKit_1_1PhasorDynamics_1_1Converter_1a16b1d29ea875a07de79a63f17a47a9ff.html
• api/reference/enum_namespaceGridKit_1_1PhasorDynamics_1_1Converter_1a584b7e7f14739c0946c4b431ec262368.html
• and 43 more...

[pelesh]

This is very helpful infrastructure contribution.

A few quick changes are required before we proceed:

• Follow developer guidelines: Once class/struct per file.
• Follow developer guidelines: File CoSim.cpp needs to be better documented with Doxygen comments.
• I would avoid catching exceptions altogether. They create potential bottlenecks with parallelization.