Migration guide v3.4.0

LoadFlowParameters version has been changed to version 1.2

The attribute t2wtSplitShuntAdmittance has been renamed as only one flag is used for all transformers (twoWindings and threeWindings). t2wtSplitShuntAdmittance is now twtSplitShuntAdmittance

The isT2wtSplitShuntAdmittance and setT2wtSplitShuntAdmittance methods are now isTwtSplitShuntAdmittance and setTwtSplitShuntAdmittance

The previous methods isT2wtSplitShuntAdmittance and setT2wtSplitShuntAdmittance have been kept as deprecated.

The current behavior is:
JSON configuration files recorded with previous version (1.1) and previous attribute tag (t2wtSplitShuntAdmittance) are supported and read.
JSON configuration files will always serialize using the current version (1.2) and the current attribute (twtSplitShuntAdmittance)

Migration of CgmesConversionContextExtension extension

The CgmesConversionContextExtension has been migrated to the new Extension API. Note that:

CgmesConversionContextExtension cgmesConversionContextExtension = new CgmesConversionContextExtension(network, context);
network.addExtension(cgmesConversionContextExtension);

will not work anymore. Please replace it by:

network.newExtension(CgmesConversionContextExtensionAdder.class)
  .withContext(context)
  .add();

Migration of CgmesModelExtension extension

The CgmesModelExtension has been migrated to the new Extension API. Note that:

CgmesModelExtension cgmesModelExtension = new CgmesModelExtension(network, cgmesModel, cgmesUpdate);
network.addExtension(cgmesModelExtension);

will not work anymore. Please replace it by:

network.newExtension(CgmesModelExtensionAdder.class)
  .withModel(cgmesModel)
  .withUpdate(cgmesUpdate)
  .add();

Migration of ThreeWindingsTransformerPhaseAngleClock extension

The ThreeWindingsTransformerPhaseAngleClock has been migrated to the new Extension API. Note that:

ThreeWindingsTransformerPhaseAngleClock threeWindingsTransformerPhaseAngleClock = new ThreeWindingsTransformerPhaseAngleClock(transformer, pacl2, pacl3);
transformer.addExtension(threeWindingsTransformerPhaseAngleClock);

will not work anymore. Please replace it by:

transformer.newExtension(ThreeWindingsTransformerPhaseAngleClockAdder.class)
  .withPhaseAngleClockLeg2(pacl2)
  .withPhaseAngleClockLeg3(pacl3)
  .add();

Migration of TwoWindingsTransformerPhaseAngleClock extension

The TwoWindingsTransformerPhaseAngleClock has been migrated to the new Extension API. Note that:

TwoWindingsTransformerPhaseAngleClock twoWindingsTransformerPhaseAngleClock = new TwoWindingsTransformerPhaseAngleClock(transformer, pac);
transformer.addExtension(twoWindingsTransformerPhaseAngleClock);

will not work anymore. Please replace it by:

transformer.newExtension(TwoWindingsTransformerPhaseAngleClockAdder.class)
  .withPhaseAngleClock(pac)
  .add();

Migration of EntsoeArea extension

The EntsoeArea has been migrated to the new Extension API. Note that:

EntsoeArea entsoeArea = new EntsoeArea(substation, code);
substation.addExtension(entsoeArea);

will not work anymore. Please replace it by:

substation.newExtension(EntsoeAreaAdder.class)
  .withCode(code)
  .add();

Migration of MergedXnode extension

The MergedXnode has been migrated to the new Extension API. Note that:

MergedXnode mergedXnode = new MergedXnode(line, rdp, xdp, xnodeP1, xnodeQ1, xnodeP2, xnodeQ2, line1Name, line2Name, code);
line.addExtension(mergedXnode);

will not work anymore. Please replace it by:

line.newExtension(MergedXnodeAdder.class)
  .withRdp(rdp)
  .withXdp(xdp)
  .withXnodeP1(xnodeP1)
  .withXnodeQ1(xnodeQ1)
  .withXnodeP2(xnodeP2)
  .withXnodeQ2(xnodeQ2)
  .withLine1Name(line1Name)
  .withLine2Name(line2Name)
  .withCode(code)
  .add();