[WIP] Extrapolation of getMinQ and getMaxQ for reactive capability curve

[SylvestreSakti]

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?

This PR adresses this issue in Open Load Flow : powsybl/powsybl-open-loadflow#1143

What kind of change does this PR introduce?
For accuracy of load flow when generators are outside their active power limits (e.g for starting generators that may have P < Pmin). We want to model the reactive limits getMinQ(p) and getMaxQ(p) in a more accurate way than just getting the reactive power limits of the bound Pmin or Pmax. (See figure given in the linked issue)

What is the current behavior?
When P < Pmin or P > Pmax, reactive limits of P : getMinQ(P) getMaxQ(P) are the values of getMinQ(Pmin) getMaxQ(Pmin) (or Pmax).

What is the new behavior (if this is a feature change)?
We introduce new methods getMinQ(double p, boolean extrapolateReactiveLimitSlope) (and same for getMaxQ(...)) that behaves like existing getMinQ(double p) if the boolean is set to false. If set to true, the reactive limit slope of the PQ diagram is extrapolated outside active power limits (as shown in the figure given in the linked issue).

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

• Yes
• No

If yes, please check if the following requirements are fulfilled

• The Breaking Change or Deprecated label has been added
• The migration steps are described in the following section

What changes might users need to make in their application due to this PR? (migration steps)

ReactiveCapabilityCurve API has been modified, introducing two methods :
getMinQ(double p, boolean extrapolateReactiveLimitSlope)
getMaxQ(double p, boolean extrapolateReactiveLimitSlope)
If extrapolateReactiveLimitSlope = false the behavior is the same as existing getMinQ(p) and getMaxQ(p)

The method must be implemented by custom IIDM implementations.

[vidaldid-rte]

Approved but marked in WIP until we understand better whether this extrapolation is justified for usual groups.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud