Migration guide v4.7.0

Additional clarifications on power flow inputs (SSH) and state values (SV)

Breaking change

To be completed

Deprecated

To be completed

Delete CGMES update to only use CGMES full export

From this release, the CGMES update mechanism is not supported anymore. You are now able to generate CGMES files from any network by using the CGMES exporter. By default, all profiles are exported (EQ, TP, SSH and SV) but you can modify the configuration if you want to export specific profiles.

For example, if you wish to export only the SSH and SV profiles, add this to your configuration:

import-export-parameters-default-value:
   iidm.export.cgmes.profiles:
         - SSH
         - SV

You can also pass a Properties object containing this configuration:

Properties properties = new Properties();
properties.put("iidm.export.cgmes.profiles", List.of("SSH", "SV"));
new CgmesExport().export(network, properties, dataSource);

Redundant attribute in ObservabilityQuality is a boolean and not a Boolean anymore

Methods in BranchObservability and InjectionObservability setting the redundant attribute of ObservabilityQuality sub-objects, such as setQualityP1(double standardDeviation, boolean redundant), do not pass a Boolean anymore but a boolean, preventing null object to be passed.

Fix IIDM transformers substation check

Transformers created directly in the network (not in a substation) must now have all of their legs directly in the network as well (not in a substation). In parallel, transformers created in a substation must now have all of their legs in this substation. Transformers with part of their legs directly in the network and part of their legs in a substation are now forbidden.

Migrate to IIDM/XIIDM 1.7

At this release, IIDM has been changed to version 1.7. Consequently, if you are using a XIIDM converter from powsybl-core v4.7.0 and above to write IIDM network files in version 1.7, you should use a XIIDM converter from powsybl-core v4.7.0 to read them as well without issues.

Please note that it is possible to read and write XIIDM files in previous IIDM-XML versions.

In order to write XIIDM files in previous versions (e.g. the version 1.0), you need to use the following configuration property:

import-export-parameters-default-value:
  iidm.export.xml.version: "1.0"

or use the Java object ExportOptions in your parameters with a suitable set version:

... // do something
ExportOptions options = new ExportOptions().setVersion("1.0");
NetworkXml.write(network, options, path);
... // do something

⚠️ Writing XIIDM files in previous versions will only be possible if the network you want to serialize has no new features or has only new features that can be interpreted in the previous versions.

Reading XIIDM files in previous versions does not require any particular configuration.

For more information about the new features, please read the documentation page on IIDM/IIDM-XML 1.7 evolutions.

These new features and changes include:

• Introducing the concept of network validation level

Create powsybl-iidm-modification

To be completed

Replace simulShunt in LoadFlowParameters by shuntCompensatorVoltageControlOn

Breaking change

simulShunt and all associated methods in LoadFlowParameters have been replaced by shuntCompensatorVoltageControlOn.

Deprecated

All previous methods have been deprecated and call new methods.

Improvements on Security Analysis API

To be completed

Sensitivity Analysis API

To be completed