Migration guide v2.8.0

Migrate powsybl-core version to v4.7.0

In this release, powsybl-core version has been updated from version 4.6.1 to 4.7.0. No corresponding migration issue should affect you directly on powsybl-line-diagram. Nonetheless, if you are also using powsybl-core directly, please refer to powsybl-core migration guide to fix any issue due to that migration.

Up to N FeederInfos

Since this release, several changes have been done in LayoutParameters to better support the drawing of more than 2 FeederInfo. Indeed, FeederInfo has replaced InitialValue in 2.5.0 release and is now used for other information than the active / reactive powers with arrows. Therefore:

• LayoutParameters::arrowDistance has been renamed to LayoutParameters::feederInfosOuterMargin, it corresponds to the space used for the margin between the feeder node and the first FeederInfo;
• LayoutParameters::minSpaceForFeederArrows has been renamed to LayoutParameters::spaceForFeederInfos, it corresponds to the space used for all the FeederInfo, please use a value big enough for the maximum number of FeederInfo you need to display;
• LayoutParameters::feederArrowSymmetry has been renamed to LayoutParameters::feederInfoSymmetry;
• LayoutParameters::feederInfosIntraMargin has been introduced to give the space between two consecutive FeederInfo (before this release the space between two FeederInfo corresponded to the height of the arrow component).

Force substation layout removed

The ForceSubstationLayout class and therefore powsybl-single-line-diagram-force-layout artifact have been removed, as the layout results were not convincing.

Refactoring

Model package refactoring

The coordinate package has been introduced in model package, and the following classes moved to that new package: Coord, Orientation, Point, Position, Side.

MiddleTwtNode dependency to Graph removed

The two transformer node classes Middle2WTNode and Middle3WTNode now have their constructors changed to remove the Graph argument. For Middle3WTNode, a boolean is then needed to know if the node is inside a voltage level or between two voltage levels.