CGMES export - Add a parameter to export generators in local regulation mode

[rcourtier]

Please check if the PR fulfills these requirements

• The commit message follows our guidelines
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

Does this PR already have an issue describing the problem?

No

What kind of change does this PR introduce?

New feature

What is the current behavior?

Generator regulation in CGMES reflects the generator regulation in IIDM

What is the new behavior (if this is a feature change)?

It is now possible to set a parameter in the CGMES export to force the generator regulation mode to local: iidm.export.cgmes.export-generators-in-local-regulation-mode.
It only affects the CGMES generated files, not the IIDM model. Also it only concerns voltage regulating generators, not the reactive power regulating generators.
When the parameter is set to true:

• The Generator's RegulatigControl.Terminal in the CGMES EQ is set to the Generator's own terminal.
• The RegulatingControl.targetValue in the CGMES SSH is adapted (the engineering value is rescaled in accordance with the new terminal, but the per unit value remains the same)

When the parameter is set to false (default value), the old behaviour is kept: Generator regulation in CGMES reflects the generator regulation in IIDM.

Does this PR introduce a breaking change or deprecate an API?

• Yes
• No

Other information:

See #3192 for setting a generator's regulation mode to local in the IIDM model.

[sonarcloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarCloud