Migration guide v4.8.0

Migration guide

Loadflow parameters

Implementation-specific parameters must now define their support for reading/writing in the corresponding LoadFlowProvider implementation. This allows to have a stronger link between a loadflow implementation and its parameters, and to rely on only one service implementation, instead of 3 before, which makes the implementation more clear.

More specifically, LoadFlowParameters.ConfigLoader and JsonLoadFlowParameters.ExtensionSerializer service interfaces have been removed. You need to move the corresponding implementation code into the following new methods:

public class MyLoadFlow implements LoadFlowProvider {
    // run method implementation
    ...
 
    // Return your JSON serializer
    Optional<ExtensionJsonSerializer> getSpecificParametersSerializer() {
        return Optional.of(new MyParametersSerializer());
    }

    // Load from config
    Optional<Extension<LoadFlowParameters>> loadSpecificParameters(PlatformConfig config) {
        return MyParameters.load(config);  // typically implemented in the extension class
    }
}

TieLine characteristics computation

An implementation of TieLine should rely on utility methods to compute the right values of its characteristics. The methods are avalable in class TieLineUtil in iidm-api. Just call getB1(half1, half2) in our implementation to get the right way to compute B1 through the equivalent branch admittance matrix.

Refactoring of CgmesIidmMapping to make it optional

From this version, the CgmesIidmMapping extension only contains the topological mapping and is optional for the CGMES export: it is not required in the input network nor is it created. The base voltage mapping is now in the BaseVoltageMapping extension, that can be in the input network or is created in the method addIidmMapping(Network) of CgmesExportContext.

Add HVDC AC emulation parameter

From this version, a hvdcAcEmulation field has been added in LoadFlowParameters. It allows an AC emulation for HVDC lines.

New sensitivity function types

From this version, there are new SensitivityFunctionType indicating the branches' sides and allowing the modelling of BUS_VOLTAGE. Previous values are deprecated.