v6.3.1

Release notes

IIDM

Network modifications

• Report removed injections when removing voltage levels (#2984)

Contingency

• Add missing battery contingency validation (#2973)

Load flow

• Fix hvdcAcEmulation option loading from a yaml config file (#2966)

CGMES

• CGMES metadata model interface and implementation (#2988)
• CGMES export: fix regression on external explicit SV dependencies using network properties (#2991)
• CGMES export: allow external metadata model definition through parameter (#2993)
• CGMES export: modeling authority must be preserved (#2996)
• Fix CGMES GL import (#2992)

Time series

• Add back static method parseCsv without ReportNode for TimeSeries (#2962)

🛡️ Vulnerability fix

• Bump org.xmlunit:xmlunit-core from 2.9.1 to 2.10.0. Fixes GHSA-chfm-68vv-pvw5 (#2997)

v6.3.0

To fix any issues due to migration, please go to the migration guide. Labels are clickable and lead to the section of the migration guide corresponding to the associated described change.

• indicates that some methods were deprecated;
• indicates a breaking change which could impact all users;
• indicates a breaking change impacting only custom IIDM implementations (most of the time, new IIDM methods/classes to implement). Note that this label is not added when another breaking change impacting all users is also present.

⭐ Key features

• Reporter API v2 (#2201, #2957, #2958)
• Limit reduction API (#2760, #2948, #2949, #2950, #2954)
• CGMES import/export fixes and improvements

📜 Release notes

IIDM

• Add VoltageRegulation extension for batteries (#2919)
• Export ActivePowerControl extension in all versions of IIDM (#2914)
• Bug fix: move properties during network merge and detach (#2934)
• Limit reduction API (#2760, #2948, #2949, #2950, #2954)
• Utility classes for reduced limits computation (#2912) ⚠️ this is a beta feature: we do not guarantee that the general design will still be the same in the next releases
• Add a pairing key setter for unpaired dangling lines (#2904)
• Support of validation level for missing permanent limit (#2939)
• Fix reference terminal extension managing cloned variants (#2956)
• Fix BoundaryImpl getters when generation not null (#2960)

Load flow

• LoadFlowParameters: default value of writeSlackBus parameter to true (#2922)

Security analysis

• Limit reduction API (#2760, #2948, #2949, #2950, #2954)
• Use double format for limit reduction values (#2935)
• Conditional actions results (#2938)

Actions

• Move actions to a new powsybl-action-api module (#2923)
• Dangling Line Action (#2903)
• Add action builders and a new action list with network element identifiers (#2952)

Contingency

• Add name in contingency for open rao (#2890)
• Add new field name in equals and hash code of Contingency (#2915)
• Add "tieLineCriterion" in options for contingency list type deserialization (#2881)
• Move criterion package and criterion serializer/deserializer to dedicated powsybl-iidm-criteria module (#2793)
• Add a way to get the elements not found in the network for every contingency (#2830)
• Allow JsonContingencyListLoader to load all json contingency lists (#2945)
• More robust VoltageIntervals (#2951)

Sensitivity analysis

• Sensitivity function: add new SensitivityFunctionType BUS_REACTIVE_POWER (#2930)

CGMES

• Export: Add custom model version for CGMES export (#2875)
• Export: UUID of fullModel on each file should be unique (#2888)
• Export: Add a business process parameter used for UUIDs generation (missing information) (#2889)
• Export: Updated export of busbar section terminals (#2886)
• Export: UUIDs with a leading underscore are considered valid master resource ids (#2896)
• Import: remove obsolete parameter and methods from config (#2882)
• Operational Limits conversion: minor improvements (#2873)
• Import: simplify the creation of tie lines when no subnetworks are present (assembled models) (#2872)
• Import: fix access to busbar section container in bus/breaker import (#2910)
• Import: condensers shall not have generating units (#2905)
• Export RegulatingControl only when generator has voltage regulation capability (#2909)
• Export: support of fossilFuel and hydroPowerPlant (#2749)
• Import and export: use reference priority extension instead of slack terminal extension (#2921)
• Export: tie lines as two separate equipment (ACLSs) (#2619)
• Import: fix performance regression checking for condensers (#2933)
• CGMES metadata models extension (#2898)
• Export tculControlMode as volt by default in CGMES 2.4.15 and prevent export of the attribute in 3.0 (#2929)
• Export: preserve original class of generators (#2726)
• Import: fix support for ACLineSegments contained in cim:Line containers (#2944)

AMPL

• Converter: add export sorting option (#2893)

iAL

• Move iAL actions DSL and simulator to new powsybl-action-ial-... modules (#2923)

Matpower

• DC lines import (#2425)
• Dangling line export bugs (#2918)

Math

• Sparse matrices serialization (#2834)

PSSE

• Fix Q record management (#2936)

Scalable

• LoadScalable: Do not apply constant power factor if P0 is zero (#2897)

Time series

• AbstractMinMaxNodeCalc extends AbstractSingleChildNodeCalc (#2906)
• Improving NodeCalc computing (#2899)
• Default version number for unversioned TimeSeries (#2925)

Tools

• Fix build timestamp when displaying powsybl version (#2911)

Commons

• Reporter API v2 (#2201, #2957, #2958)

Dependencies

• Update to powsybl-parent 18 (#2823)

Quality

• Restrict permissions in github workflow (#2825)
• Missing license and author in test file (#2892)
• Short-circuits: corrections in javadoc (#2887, #2894, #2907)
• Update README.md with scorecard badge (#2902)
• Remove dead link to tutorial in README (#2858)
• More detailed exception when JSON parsing (#2941)
• Add missing SPDX license identifiers (#2953)

🛡️ Vulnerability fix

• Bump org.apache.commons:commons-compress from 1.24.0 to 1.26.0. Fixes CVE-2024-25710, CVE-2024-26308 (#2901)
• Bump org.apache.commons:commons-configuration2 from 2.9.0 to 2.10.1. Fixes CVE-2024-29131, CVE-2024-29133 (#2947)

6.2.4

Release notes

CGMES

• Import: fix performance regression checking for condensers (#2933)

🛡️ Vulnerability fix

• Bump org.apache.commons:commons-configuration2 from 2.9.0 to 2.10.1. Fixes CVE-2024-29131, CVE-2024-29133 (#2947)

v6.3.0-alpha-1

To fix any issues due to migration, please go to the migration guide. Labels are clickable and lead to the section of the migration guide corresponding to the associated described change.

• indicates that some methods were deprecated;
• indicates a breaking change which could impact all users;
• indicates a breaking change impacting only custom IIDM implementations (most of the time, new IIDM methods/classes to implement). Note that this label is not added when another breaking change impacting all users is also present.

⭐ Key features

• Reporter API v2 (#2201)
• Limit reduction API (#2760)
• CGMES import/export fixes and improvements

📜 Release notes

IIDM

• Add VoltageRegulation extension for batteries (#2919)
• Export ActivePowerControl extension in all versions of IIDM (#2914)
• Bug fix: move properties during network merge and detach (#2934)
• Limit reduction API (#2760)
• Add a pairing key setter for unpaired dangling lines (#2904)

Load flow

• LoadFlowParameters: default value of writeSlackBus parameter to true (#2922)

Security analysis

• Dangling Line Action (#2903)
• Limit reduction API (#2760)
• Use double format for limit reduction values (#2935)
• Move actions to a new powsybl-action-api module (#2923)

Contingency

• Add name in contingency for open rao (#2890)
• Add new field name in equals and hash code of Contingency (#2915)
• Add "tieLineCriterion" in options for contingency list type deserialization (#2881)
• Move criterion package and criterion serializer/deserializer to dedicated powsybl-iidm-criteria module (#2793)

Sensitivity analysis

• Sensitivity function: add new SensitivityFunctionType BUS_REACTIVE_POWER (#2930)

CGMES

• Export: Add custom model version for CGMES export (#2875)
• Export: UUID of fullModel on each file should be unique (#2888)
• Export: Add a business process parameter used for UUIDs generation (missing information) (#2889)
• Export: Updated export of busbar section terminals (#2886)
• Export: UUIDs with a leading underscore are considered valid master resource ids (#2896)
• Import: remove obsolete parameter and methods from config (#2882)
• Operational Limits conversion: minor improvements (#2873)
• Import: simplify the creation of tie lines when no subnetworks are present (assembled models) (#2872)
• Import: fix access to busbar section container in bus/breaker import (#2910)
• Import: condensers shall not have generating units (#2905)
• Export RegulatingControl only when generator has voltage regulation capability (#2909)
• Export: support of fossilFuel and hydroPowerPlant (#2749)
• Import and export: use reference priority extension instead of slack terminal extension (#2921)
• Export: tie lines as two separate equipment (ACLSs) (#2619)
• Import: fix performance regression checking for condensers (#2933)

AMPL

• Converter: add export sorting option (#2893)

iAL

• Move iAL actions DSL and simulator to new powsybl-action-ial-... modules (#2923)

Matpower

• DC lines import (#2425)
• Dangling line export bugs (#2918)

Math

• Sparse matrices serialization (#2834)

Scalable

• LoadScalable: Do not apply constant power factor if P0 is zero (#2897)

Time series

• AbstractMinMaxNodeCalc extends AbstractSingleChildNodeCalc (#2906)
• Improving NodeCalc computing (#2899)

Tools

• Fix build timestamp when displaying powsybl version (#2911)

Commons

• Reporter API v2 (#2201)

Dependencies

• Update to powsybl-parent 18 (#2823)

Quality

• Restrict permissions in github workflow (#2825)
• Missing license and author in test file (#2892)
• Short-circuits: corrections in javadoc (#2887, #2894, #2907)
• Update README.md with scorecard badge (#2902)
• Remove dead link to tutorial in README (#2858)

🛡️ Vulnerability fix

• Bump org.apache.commons:commons-compress from 1.24.0 to 1.26.0. Fixes CVE-2024-25710, CVE-2024-26308 (#2901)

v6.2.3

Release notes

⚠️ Important

Do not use this version for CGMES purposes. The CGMES import takes a very long time (~ x8 longer)!

CGMES

• Import: fix access to busbar section container in bus/breaker import (#2910)
• Import: condensers shall not have generating units (#2905)

Tools

• Fix build timestamp when displaying powsybl version (#2911)

v6.2.2

Release notes

🛡️ Vulnerability fix

• Bump org.apache.commons:commons-compress from 1.24.0 to 1.26.0. Fixes CVE-2024-25710, CVE-2024-26308 (#2901)

v6.2.1

Release notes

CGMES

• [CGMES] Add custom model version for CGMES export (#2875)
• [CGMES export] UUID of fullModel on each file should be unique (#2888)
• [CGMES export] Add a business process parameter used for UUIDs generation (missing information) (#2889)
• [CGMES export] Updated export of busbar section terminals (#2886)
• [CGMES export] UUIDs with a leading underscore are considered valid master resource ids (#2896)

Scalable

• LoadScalable: Do not apply constant power factor if P0 is zero (#2897)

Documentation

• [Shortcircuit API] Fix javadoc (#2887)

v6.2.0

To fix any issues due to migration, please go to the migration guide. Labels are clickable and lead to the section of the migration guide corresponding to the associated described change.

• indicates that some methods were deprecated;
• indicates a breaking change which could impact all users;
• indicates a breaking change impacting only custom IIDM implementations (most of the time, new IIDM methods/classes to implement). Note that this label is not added when another breaking change impacting all users is also present.

Release notes

IIDM

• Precise error and log messages for extensions (#2824)
• Add case date handling when merging networks (#2845)
• Add a tap changer steps replacer (#2828, #2829)
• Notification system for extensions (#2852)
• Secondary voltage control notifications (#2852, #2859, #2860)
• Connectable connect/disconnect (#2831)
• Connection/disconnection notification (#2854)
• Binary IIDM export / import support (#2853, #2871) ⚠️ this is a beta feature: we do not guarantee that the produced files will still be readable in the next release
• Fix deserialization bug in skipped extensions (#2863)
• Network reduction: Fix the replacement of HVDC lines with VSC conversion stations in voltage regulation by regulating generators (#2867)
• Sort the dangling lines when creating a tie line to ensure reproducibility (#2874)

IIDM v1.12

Please refer to the detailed documentation of new version IIDM v1.12.

• Bump IIDM version to 1.12 (#2816)
• Fix equipment XSD (#2864)
• Add reactive power control mode to ratio tap changers (#2758)
• Automation systems: Overload management systems (#2779, #2844, #2865)
• New "Ground" injection (#2837)
• A Permanent limit is now mandatory if temporary limits (#2636)
• New operational limits management using groups of operational limits (#2802, #2870)

Network modification

• Connectable connection/disconnection (#2831)

CGMES

• CGMES export: fix SV voltage of tie line boundary node (#2841)
• CGMES import: multiple grid models as a network with subnetworks (#2775)
• CGMES export: add model ID to reporter during export (#2851)
• CGMES export: modify CGMES naming strategy so that the IDs are stable (#2804)
• CGMES export: fix dependencies for 2.4.15 (#2855)
• CGMES import: import ground objects (#2848, #2857, #2877)
• CGMES export: fix missing breaker (#2840)
• CGMES: Correct neutral step calculation for tap changers (#2866, #2869)
• CGMES export: export mRID only for CGMES 3 (CIM 100) or greater (#2876)

Security analysis

• Rework of LineConnectionAction to TerminalsConnectionAction (#2843)

Math

• Fix sparse matrix construction from CSC arrays (#2839)

Time series

• Add new type of NodeCalc to compute Min/Max between timeseries (#2820, #2846)

Quality

• Pinned versions for GitHub actions (#2821)
• Fix typo in ConversionTool argument description (#2842)
• Update all pom.xml files to use project.groupId (#2803)
• Fix http link in pom.xml (#2856)

v6.1.2

Release notes

• Fix deserialization bug in skipped extensions (#2863)

v6.2.0-RC1

To fix any issues due to migration, please go to the migration guide. Labels are clickable and lead to the section of the migration guide corresponding to the associated described change.

• indicates that some methods were deprecated;
• indicates a breaking change which could impact all users;
• indicates a breaking change impacting only custom IIDM implementations (most of the time, new IIDM methods/classes to implement). Note that this label is not added when another breaking change impacting all users is also present.

Release notes

IIDM

• Precise error and log messages for extensions (#2824)
• Add case date handling when merging networks (#2845)
• Add a tap changer steps replacer (#2828, #2829)
• Notification system for extensions (#2852)
• Secondary voltage control notifications (#2852, #2859, #2860)
• Connectable connect/disconnect (#2831)
• Connection/disconnection notification (#2854)
• Binary IIDM export / import support (#2853) ⚠️ this is a beta feature: we do not guarantee that the produced files will still be readable in the next release

IIDM v1.12

Please refer to the detailed documentation of new version IIDM v1.12.

• Bump IIDM version to 1.12 (#2816)
• Add reactive power control mode to ratio tap changers (#2758)
• Automation systems: Overload management systems (#2779, #2844)
• New "Ground" injection (#2837)
• A Permanent limit is now mandatory if temporary limits (#2636)
• New operational limits management using groups of operational limits (#2802)

Network modification

• Connectable connection/disconnection (#2831)

CGMES

• CGMES export: fix SV voltage of tie line boundary node (#2841)
• CGMES import: multiple grid models as a network with subnetworks (#2775)
• CGMES export: add model ID to reporter during export (#2851)
• CGMES export: modify CGMES naming strategy so that the IDs are stable (#2804)
• CGMES export: fix dependencies for 2.4.15 (#2855)
• CGMES import: import ground objects (#2848, #2857)
• CGMES export: fix missing breaker (#2840)

Security analysis

• Rework of LineConnectionAction to TerminalsConnectionAction (#2843)

Math

• Fix sparse matrix construction from CSC arrays (#2839)

Time series

• Add new type of NodeCalc to compute Min/Max between timeseries (#2820, #2846)

Quality

• Pinned versions for GitHub actions (#2821)
• Fix typo in ConversionTool argument description (#2842)
• Update all pom.xml files to use project.groupId (#2803)
• Fix http link in pom.xml (#2856)