Migration guide v6.0.0

Breaking changes

IIDM: 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 depreciated

The Scaling parameter iterative has been depreciated and is 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 depreciated, 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

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