Migration guide v3.1.0

powsybl-single-line-diagram

AbstractBaseVoltageDiagramStyleProvider changes

isNodeConnectingVoltageLevels(node) protected method has been renamed to isNodeConnectingElectricalNodes(node) because of the voltage level internal phase-shift transformers and because of the voltage level internal two-winding transformers. To return that property, we can use the underlying network equipments, that's why a new isMultiTerminalNode(node) protected method has been introduced. In case you're using that class with a null network, you can override this with the following code based on the componentType:

return ComponentTypeName.TWO_WINDINGS_TRANSFORMER.equals(node.getComponentType())
        || ComponentTypeName.THREE_WINDINGS_TRANSFORMER.equals(node.getComponentType())
        || ComponentTypeName.PHASE_SHIFT_TRANSFORMER.equals(node.getComponentType())
        || ComponentTypeName.VSC_CONVERTER_STATION.equals(node.getComponentType())
        || ComponentTypeName.LINE.equals(node.getComponentType());

Representation of internal two-winding transformers

The 3.1.0 release provides a new representation of internal two-winding transformers, within a cell. This representation is, we believe, more compact and more readable.

For projects using a RawGraphBuilder and implementing their own NetworkGraphBuilder, the new representation is a choice to make, a possibility offered by the 3.1.0 release. If you are using a RawGraphBuilder and are willing to represent two-winding transformers within cells, you have to make further modifications into your own code: an EquipmentNode has to be used to represent the transformer instead of a FeederNode. The function createInternal2WTNode(...) from the NodeFactory creates such a Node.