Migration guide v7.1.0

Breaking changes for all users

IIDM

IIDM 1.15

Adaptations for IIDM 1.15

Downstream projects should:

• Check in their versionable extensions' serializers/deserializers (classes extending AbstractVersionableNetworkExtensionSerDe) that a SerDeVersion value supports the new version (1.15) (usually, at least a SerDeVersion has its maxIidmVersionExcluded attribute set to null. In this case, there is nothing to do the the SerDe.);

• Upgrade the version in their XIIDM / JIIDM unit test files corresponding to the current version:

  • For ".xiidm" or ".xml" files: replace xmlns:iidm="http://www.powsybl.org/schema/iidm/1_14" with xmlns:iidm="http://www.powsybl.org/schema/iidm/1_15";

  • For ".json" or ".jiidm" files: replace "version" : "1.14" with "version" : "1.15".

CGMES

Renaming CGMES shortcircuit package

Package com.powsybl.cgmes.shorcircuit was renamed into com.powsybl.cgmes.shortcircuit. (Fixes "short" )

SV data at CGMES update

• DCLinkUpdate.DefaultData record has 2 new attributes double poleLosses1 and double poleLosses2.
• CGMES conversion's com.powsybl.cgmes.conversion.elements.transformers.TapChanger class has no more setSolvedTapPosition(Integer) and Integer getSolvedTapPosition() methods.

Notice for custom IIDM implementations maintainers

AC/DC Converters without a PCC Terminal

Custom IIDM implementations should adapt to the updated AC/DC Converters validation rules tested in IIDM TCK:

• com.powsybl.iidm.network.tck.AbstractAcDcConverterTest#testCreationError
• com.powsybl.iidm.network.tck.AbstractAcDcConverterTest#testTwoAcTerminals

Droop control mode for AC/DC converters

If you defined your own IIDM implementation, you should:

• Write your own implementations of DroopCurve and DroopCurveAdder
• Implement the following methods in your AcDcConverter implementations:
  • DroopCurveAdder newDroopCurve()
  • DroopCurve getDroopCurve()

Deprecated methods