IIDM & XIIDM 1.2 evolutions

Features

Regulation for ShuntCompensator

Shunt compensators can now be regulated. New attributes (regulation (boolean), targetV (double), targetDeadband (double) and regulatingTerminal (Terminal)) have been added to ShuntCompensator and can be set and accessed. However, to serialize or deserialize a shunt compensator with any of these attributes with a non-default value, IIDM-XML version 1.1 must be used. Otherwise, the serialization and deserialization will fail.

To know more about these attributes and their default values, go to the documentation page of ShuntCompensator.

targetDeadband attribute in RatioTapChanger and PhaseTapChanger

The attribute targetDeadband in RatioTapChanger and PhaseTapChanger is now required if RatioTapChanger.regulating is set to true or PhaseTapChanger.regulationMode is not set to FIXED_TAP.

If targetDeadband is not defined in these cases, an exception will be thrown. Hence, add the line:

tapChangerAdder.setTargetDeadband(0.0);

to keep the same behavior as before. Of course, you can also add another value if it is more appropriate to your use case. At any rate, in the cases described above, targetDeadband should not be Double.NaN.

Apparent power attribute for TwoWindingsTransformer and ThreeWindingsTransformer.Leg

A new optional attribute ratedS in TwoWindingsTransformer and ThreeWindingsTransformer.Leg has been introduced to model apparent power. If ratedS is not set to Double.NaN, it should not be strictly inferior to 0.0.

Deletion of nodeCount attribute in nodeBreakerTopology

TODO

New Shunt Compensator model

Breaking change in shunt compensator's API

TODO

Serialization change for shunt compensators

TODO