Migration guide v6.0.0

Breaking changes

IIDM

Subnetworks

network.merge(other);

has been deleted.

Instead, new static Network functions have been implemented:

Network.create("id", network1, network2);

Or more simply:

Network.create(network1, network2);

Networks can be merged one with another and on the opposite, subnetworks can be detached from a parent network:

Creating a merged network merge from two networks n1 and n2:

Network merge = Network.create("merge", n1, n2);

Detaching n2 from the parent network:

Network subnetwork1 = merge.getSubnetwork(n1.getId());
Network detachedN1 = subnetwork1.detach();

Detaching a subnetwork is a destructive procedure: the detached network is not accessible from the parent network anymore. Before launching this operation, checks are performed:

• Detaching from multi-variants network is not supported;
• Un-splittable boundary elements (like lines or HVDC lines) prevent the subnetwork to be detached;
• VoltageAngleLimits defined at the boundaries of a subnetwork prevent that subnetwork to be detached.

Delete Merging View implementation

TODO: explain the changes and add an example

Traversal from terminal by depth or by breadth first

• When using UndirectedGraph.traverse(...) methods, you now have to specify the TraversalType describing the way the graph will be traversed (by depth or by breadth). The previous default was TraversalType.DEPTH_FIRST;
• Terminal implementations should have a void traverse(TopologyTraverser traverser, TraversalType traversalType) method. If you don't need breadth first travel, you could use the following implementation:

    @Override
    public void traverse(TopologyTraverser traverser, TraversalType traversalType) {
        if (traversalType == TraversalType.DEPTH_FIRST) {
            traverse(traverser);
        }
        throw new UnsupportedOperationException("Unsupported traversal type");
    }

Scaling modifications

Float to double

Floats were changed to doubles in the different scaling methods and constructors, check the values you are using.

For example variation = proportional([50.0f,20.0f,30.0f], gens) doesn't work anymore, use variation = proportional([50.0d,20.0d,30.0d], gens) instead.

Scaling parameter iterative deprecated

The Scaling parameter iterative has been deprecated and is being replaced by the enum priority (ScalingParameter.Priority).

public enum Priority {
        RESPECT_OF_VOLUME_ASKED,
        RESPECT_OF_DISTRIBUTION,
        ONESHOT
    }

The values can be either RESPECT_OF_VOLUME_ASKED (the scaling will distribute the power asked as much as possible by iterating if elements get saturated, even if it means not respecting potential percentages), RESPECT_OF_DISTRIBUTION (the scaling will respect the percentages even if it means not scaling all what is asked), or ONESHOT (the scaling will distribute the power asked as is, in one iteration even if elements get saturated and even if it means not respecting potential percentages).

All the methods using the former iterative parameter have been deprecated and will be deleted in a future release, replace them with their equivalent using the priority parameter.

For instance:

        ScalingParameters parameters = new ScalingParameters()
                .setScalingConvention(Scalable.ScalingConvention.LOAD)
                .setConstantPowerFactor(true)
                .setIterative(true)
                .setReconnect(true)
                .setAllowsGeneratorOutOfActivePowerLimits(true);

should be replaced by:

        ScalingParameters parameters = new ScalingParameters()
                .setScalingConvention(Scalable.ScalingConvention.LOAD)
                .setConstantPowerFactor(true)
                .setPriority(RESPECT_OF_VOLUME_ASKED)
                .setReconnect(true)
                .setAllowsGeneratorOutOfActivePowerLimits(true);

Compatibility

Java version support

PowSyBl-Core now only supports Java 17 and higher. Please check that your installed SDK is still compatible. If you are using Ubuntu 20.04 LTS and the preinstalled Maven version, you will need to upgrade your Maven version too at least up to a version 3.8.x.

Quality

Runtime dependencies

Groovy dependencies have been upgraded from version 3.0.15 to 4.0.14. Since the version 4, the groupId of their maven artifacts was changed from org.codehaus.groovy to org.apache.groovy. If you use Groovy dependencies in your project, you should update your pom.xml.

For instance:

        <dependency>
            <groupId>org.codehaus.groovy</groupId>
            <artifactId>groovy</artifactId>
        </dependency>

should be replaced by:

        <dependency>
            <groupId>org.apache.groovy</groupId>
            <artifactId>groovy</artifactId>
        </dependency>

Note that the packages were not changed. Thus, you don't have to update your Java imports.

Deprecated methods clean-up

The following deprecated methods have been deleted:

• AbstractScalable.listGenerators()
• BranchTripping.getBranchId()
• Bus.getTwoWindingTransformers()
• Bus.getTwoWindingTransformerStream()
• Bus.getThreeWindingTransformers()
• Bus.getThreeWindingTransformerStream()
• CgmesBoundary.addEquipmentAtNode()
• CgmesBoundary.equipmentAtNode()
• CgmesModel.terminalForEquipment()
• CgmesModel.ratioTapChangerForPowerTransformer()
• CgmesModel.phaseTapChangerForPowerTransformer()
• Identifiable.getName()
• Identifiable.getProperties()
• InMemoryCgmesModel.ratioTapChangerForPowerTransformer()
• InMemoryCgmesModel.phaseTapChangerForPowerTransformer()
• LimitViolationUtils.Branch.Overload checkTemporaryLimits()
• LimitViolationUtils.checkPermanentLimit()
• LoadFlowParameters.isSpecificCompatibility()
• LoadFlowParameters.isT2wtSplitShuntAdmittance()
• LoadFlowParameters.setSpecificCompatibility()
• LoadFlowParameters.setT2wtSplitShuntAdmittance()
• Networks.printBalanceSummary()
• NodBreakerVoltageLevel.getNodeCount()
• Scalable.listGenerators()
• Scalable.gen()
• StaticVarCompensator.getVoltageSetPoint()
• StaticVarCompensator.setVoltageSetPoint()
• StaticVarCompensator.getReactivePowerSetpoint()
• StaticVarCompensator.setReactivePowerSetPoint()
• StaticVarCompensatorAdder.setVoltageSetPoint()
• StaticVarCompensatorAdder.setReactivePowerSetPoint()
• ValidationUtil.checkActivePowerLimits()
• VoltageLevel.getNodeCount()

The following deprecated enum types have been deleted:

• SensitivityFunctionType.BRANCH_ACTIVE_POWER
• SensitivityFunctionType.BRANCH_CURRENT