Decoupling ITM

[pipeacosta]

This PR implements new decoupling elements based on the Ideal Transformer Model (ITM) for exemplifying co-simulation scenarios.

This PR renames the Python API (dpsimpy) function add to add_component.

[codecov]

Codecov Report

❌ Patch coverage is 63.89189% with 334 lines in your changes missing coverage. Please review.
✅ Project coverage is 67.64%. Comparing base (2732152) to head (154dd85).

Files with missing lines	Patch %	Lines
.../src/Signal/DecouplingIdealTransformer_EMT_Ph1.cpp	0.00%	112 Missing ⚠️
...im/examples/cxx/Circuits/SP_ITM_withPiLine_Ph1.cpp	0.00%	101 Missing ⚠️
.../src/Signal/DecouplingIdealTransformer_EMT_Ph3.cpp	84.61%	18 Missing ⚠️
...s/src/Signal/DecouplingIdealTransformer_DP_Ph1.cpp	86.84%	15 Missing ⚠️
...s/src/Signal/DecouplingIdealTransformer_SP_Ph1.cpp	86.84%	15 Missing ⚠️
...models/Signal/DecouplingIdealTransformer_EMT_Ph1.h	0.00%	12 Missing ⚠️
...m-models/src/DP/DP_Ph1_ControlledVoltageSource.cpp	82.60%	12 Missing ⚠️
...m-models/src/SP/SP_Ph1_ControlledCurrentSource.cpp	78.18%	12 Missing ⚠️
...m-models/src/SP/SP_Ph1_ControlledVoltageSource.cpp	83.33%	11 Missing ⚠️
...m-models/src/DP/DP_Ph1_ControlledCurrentSource.cpp	84.31%	8 Missing ⚠️
... and 4 more

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #423      +/-   ##
==========================================
+ Coverage   67.40%   67.64%   +0.23%     
==========================================
  Files         426      443      +17     
  Lines       25995    26917     +922     
  Branches    13217    13672     +455     
==========================================
+ Hits        17523    18209     +686     
- Misses       8471     8621     +150     
- Partials        1       87      +86     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[leonardocarreras]

Hi Andres! Thanks for the PR! This is just a quick first comment. We can discuss more and see how to integrate it.

[leonardocarreras]

Hi Andres! Please have a look to the comments! Thanks for the PR!

[leonardocarreras]

Hi Andres! Thanks for updating your PR!

Here some suggestions/questions:

• The ITM variants have internal virtual nodes and 4 sub-components (mRes1, mRes2, mVoltageSrc, mCurrentSrc), which is exactly what CompositePowerComp is designed for. Using CompositePowerComp would also fix the missing virtual node registration bug. This could also be a future refactor.
• Please do not use the copyright block and instead use the SPDX headers.

/* SPDX-FileCopyrightText: 2026 Institute for Automation of Complex Power Systems, EONERC, RWTH Aachen University
 * SPDX-License-Identifier: MPL-2.0
 */

• Breaking changes need to be explicitly mentioned (Python API case of SystemTopology.add)

Please feel free to propose a different way.