v5.3.0-alpha-2

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

Release notes

IIDM

• SV: support of DC approximation (#2589)
• Branch does not extend connectable (#2591)

Network modifications

• Support of ShuntCompensatorModification (#2588)

CGMES

• Fixes in CGMES export (#2574)

v5.3.0-alpha-1

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

Release notes

IIDM

• Move FourSubstationsNodeBreakerWithExtensionsFactory to iidm-test (#2544)
• Load and line asymmetrical data extensions (#2533)
• Fix hvdc removal reporting (#2559)
• Fix severity for remove vl or hvdc reports (#2558)
• Improve move connectable notification (#2562)
• European LV test feeder case (#2542)
• Bump iidm xml version to 1.10 (#2466)
• Fix writing zero bPerSection for xiidm <1.5 for iidm4cpp (#2560)
• Replace HalfLine by DanglingLine (#2437, #2585, #2587)
• IIDM zip and exponential load model (#2555)
• Load zip model: allow negative coefficients (#2579)
• Remove Xnode/mergedXnode extensions (#2568)
• Add HvdcUtils (#2567)
• Add new network (generator, VSC, SVC, tap changers, shunt compensator) modifications (#2557)

CGMES

• CGMES pre-processors (#2513)
• Add methods to access supplementary data in CGMES boundaries (#2525)
• Add method to retrieve CN from Xnode in CgmesBoundary (#2556)
• CGMES EQ export fixes (#2528 & #2546)
  • Fix tculControlMode in CGMES export: it is a reference and not a field
  • Add SynchronousMachine.type attribute
  • LinearShuntCompensator.gPerSection is not optional
  • Add WindGeneratingUnit.windGenUnitType attribute
  • Fix stepVoltageIncrement to not be infinite
  • Bug fix: when creating or referencing TN for disconnected switches, naming strategy is called
  • Name is truncated to 32 characters in CGMES export (Quality check)
  • Bug fix: store all topological nodes in context to write all SvVoltage
  • Add netInterchange for control areas
  • Add TieFlow.positiveFlowIn
  • neutralU in RTC and PTC is ratedU
  • Copy dangling line limits on both sides
  • Always write SvPowerFlow for Injections and Tieflows
  • If ID of sub-region does not correspond to a name, return N/A
  • Avoid processing non-exported equipment
• CGMES import: import TATL shortName or name, not ID (#2537)
• Support of batteries export (#2527)
• CGMES export: fix calculation of flows for switches (#2582)

PSS/E

• PSSE: Q record anywhere between blocks. (#2529)
• TwoTerminalDc: Negative setvl (#2530)
• PSSE : add test cases from Illinois repository (#2538)
• PSSE: Fix duplicate IDs for NonTransformerBranches, Transformers, Loads, Generators, Shunts (fixed and switched) (#2539)
• PSSE: Support null fields in rawx format (#2540)
• switched shunt: in rawx format fields "i" and "id" must be "ibus" and "shntid" (#2541)
• Fix Lcc power factor (#2572)

Matpower

• Matpower export: add support of VSC, LCC, SVC and batteries (#2567)
• Matpower export: considering different nominal voltage (#2571)
• Matpower export: various fixes (#2578)

UCTE

• UCTE export: bug fixes on phase and ratio tap changers (#2573)

Security Analysis

• Fix: support of BusContingency in ContingencyElement (#2561)
• Factorize CriterionContingencyListSerializer classes into a single one (#2565)
• Add method checkLimitsDc with dcPowerFactor param (#2581)
• Add tie lines support in limit violation detector (#2586)

Contingency

• Add several contingency elements in identifiable lists (#2515)

Short circuits

• Add specific parameters and adapt tests. (#2552)
• Fortescue utils refactoring (#2534)

Computation

• Add command execution duration to local computation manager (#2570)

Network modifications

• Add logs when exception is thrown (#2551)
• Add parameter to allow or not a generator to scale when its initial targetP is outside minP - maxP (#2584)

Quality

• Fix duplicated junit dependency (#2577)
• TieLine iidm unit tests separated from Line iidm unit tests (#2580)

v5.2.1

Release notes

Fixes

• AMPL executor debug mode (#2531)
• Fix writing zero bPerSection for xiidm <1.5 (#2536)
• Notify listeners after invalidating cache when switches' status is updated: connectivity is then correctly taking the update into account (#2543)

v5.2.0

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

Release notes

CGMES

• Fix conversion of boundary lines: consider all (g,b) at network side (#2485)
• Add options to encode/decode CGMES IDs as they are MEMIri in triplestore and can be modified during import otherwise (#2457)
• CGMES Importer: optional creation of terminals fictitious switches (#2472)
• Create a fictitious substation during CGMES export when a voltage level does not have a substation (#2501)
• Test creation of fictitious substations when we have found line containers outside boundaries in the input (#2505)
• CGMES import: CN is a property of DLs (can not be unique to a DL) (#2508)
• CGMES import: make substations property bags distinct when their region is defined twice (in BD and IGM) (#2507)
• Cleaning of CGMES options (#2517)

IEEE

• Support lines with different nominal voltage at both ends (#2480)

Matpower

• Support lines with different nominal voltage at both ends (#2493)

IIDM

• Allow creation of voltage topology in bus/breaker voltage levels (#2447)
• Fixing minP/maxP for hvdc reduction into generator (#2475)
• Fix anonymized xml writing (#2490)
• Remove regulating terminal when the equipment it is pointing to is removed from the network (#2470)
• Use a constant name and a limit reduction for permanent limit (#2476)
• Fortescue data extensions (#2486)
• Refactoring XML IIDM serialization classes (#2481)
• Add add method to the adders API (#2502)
• Fix: BusbarSection getters in node-breaker view only return a non-null BusbarSection if it is in their voltage level (#2519)
• Fix identifiable stream (#2520)

LoadFlow

• LoadFlowParameters.toMap public (#2488)

Network modifications

• Remove voltage level and its equipments (#2464)
• Allow to create coupling devices in bus-breaker voltage levels (#2388)
• Remove Hvdc line and its converter stations (#2500)
• Creating an modification with wrong bus bar section now throws an exception (#2516)
• Fix: Remove disconnectors and breakers in RemoveHvdcLine and RemoveVoltageLevel (#2522)

Parameter

• Fix reading of double Parameters (#2524)

Scalable

• Introduce ScalingParameters for Scalable (#2461 & #2503)
• Add loading from platform config and serialization for ScalingParameters (#2510)

Security analysis

• Fix check on 0 value in tap changer tap position action (#2477)
• Add new action conditions (#2468)
• Add Hvdc action (#2454)
• Remove useless identifiableType from IdentifierContingencyList (#2491)
• Create action to change shunt compensator position (#2497)

Sensitivity Analysis

• Add side integer to SensitivityFunctionType, SensitivityVariableType (#2448)
• Add new variables and functions (#2484)
• Add sensitivity threshold parameters for sensitivities filtering (#2499)
• Fix doc for sensitivity thresholds (#2511)

Short circuit API

• Add voltage drops to the result and parameters (#2377)
• Short circuit API: replace names in FortescueValue (#2494)
• Fix units in javadoc of Shortcircuits API (#2506)

AMPL executor

• AMPL executor (#2455)
• Output reading behavior, read all files even if some throws (#2518)

Configuration

• PlaftormConfig: config folder not created if non existing (#2492)

Quality

• Bump to JUnit 5 (#2467)
• Small fix of Junit5 migration (#2471)
• Bump snakeyaml to 2.0. Fix CVE-2022-1471 (#2479)
• Replace AssertionError by IllegalStateException. (#2465)
• Fix Java 19 build (#2478)

v5.2.0-RC1

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

Release notes

CGMES

• Fix conversion of boundary lines: consider all (g,b) at network side (#2485)
• Add options to encode/decode CGMES IDs as they are MEMIri in triplestore and can be modified during import otherwise (#2457)
• CGMES Importer: optional creation of terminals fictitious switches (#2472)
• Create a fictitious substation during CGMES export when a voltage level does not have a substation (#2501)

IIDM

• Allow creation of voltage topology in bus/breaker voltage levels (#2447)
• Fixing minP/maxP for hvdc reduction into generator (#2475)
• Fix anonymized xml writing (#2490)
• Remove regulating terminal when the equipment it is pointing to is removed from the network (#2470)
• Use a constant name and a limit reduction for permanent limit (#2476)
• Fortescue data extensions (#2486)
• Refactoring XML IIDM serialization classes (#2481)
• Add add method to the adders API (#2502)

LoadFlow

• LoadFlowParameters.toMap public (#2488)

Network modifications

• Remove voltage level and its equipments (#2464)
• Allow to create coupling devices in bus-breaker voltage levels (#2388)
• Remove Hvdc line and its converter stations (#2500)

Scalable

• Introduce ScalingParameters for Scalable (#2461 & #2503)

Security analysis

• Fix check on 0 value in tap changer tap position action (#2477)
• Add new action conditions (#2468)
• Add Hvdc action (#2454)
• Remove useless identifiableType from IdentifierContingencyList (#2491)
• Create action to change shunt compensator position (#2497)

Sensitivity Analysis

• Add side integer to SensitivityFunctionType, SensitivityVariableType (#2448)
• Add new variables and functions (#2484)
• Add sensitivity threshold parameters for sensitivities filtering (#2499)

Short circuit API

• Add voltage drops to the result and parameters (#2377)
• Short circuit API: replace names in FortescueValue (#2494)

AMPL executor

• AMPL executor (#2455)

Configuration

• PlaftormConfig: config folder not created if non existing (#2492)

Quality

• Bump to JUnit 5 (#2467)
• Small fix of Junit5 migration (#2471)
• Bump snakeyaml to 2.0. Fix CVE-2022-1471 (#2479)
• Replace AssertionError by IllegalStateException. (#2465)
• Fix Java 19 build (#2478)

v5.2.0-alpha-1

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

Release notes

IIDM

• Allow creation of voltage topology in bus/breaker voltage levels (#2447)

Network modifications

• Remove voltage level and its equipments (#2464)

Sensitivity Analysis

• Add side integer to SensitivityFunctionType, SensitivityVariableType (#2448)

Short circuit API

• Add voltage drops to the result and parameters (#2377)

Quality

• Bump to JUnit 5 (#2467)

v5.1.1

Release notes

• CGMES import: active power control extension is optional (#2462)

v5.1.0

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

Release notes

CGMES

• Import ignored ACLineSegment linked to boundary as dangling lines (#2393)
• If two dangling lines with the same Xnode are in the same geographical region in a CGMES file, they are not merged (#2389)
• Import/Export CGMES Profiles IDs if present (EQ, TP, SSH, EQ_BD and TP_BD) (#2376)
• Fix SVC bMin/bMax during CGMES if capacitive and/or inductive rating are undefined or 0 (#2420)
• CGMES importer: handle GeographicalRegion in BoundarySet (#2426)
• CGMES SV export: use naming strategy to obtain proper topological node identifiers from buses (#2438)
• CGMES fix network id for CGMES3; conformity test configurations v3 (#2443)
• Clean CGMES export of tie lines/dangling lines (#2452)
• CGMES: convert cim:GeneratingUnit.normalPF to ActivePowerControl iIDM extension (#2435)

Contingency

• Add battery contingency element (#2366)
• ContingencyBuilder add identifiable (#2396)
• Add bus contingency (#2416)

DataSource

• Compression - support zstd and xz formats (#2409)

Dynamic Simulation

• Add InputStream constructor to curve and event models suppliers (#2395)

IIDM

• Boundary implementation: get voltage level of network side (#2345)
• Feeders' names in ConnectablePosition are optional (#2385)
• Active Power Control extension: add participationFactor (#2402)
• NetworkStateComparator: added three windings transformers comparison (#2415)
• Default values for network element adders (#2417)
• Implement new consistent behavior when calling merge method (uniform in NetworkImpl, MergingView and CGM import) (#2394)
• Add secondary voltage control IIDM extension (#2436)
• Allow reduction of HVDC lines (#2434)
• Bbv cache not invalidated for a retained switch when opened/closed (#2439)
• Add a new network to test security analysis (#2418) + change current limit name in security analysis test network (#2456)
• Add comparison of intermediary file in roundTrip (#2449)
• Bump XIIDM to 1.9
  • Fix shunt P serialization
  • Improve IidmXmlVersion

IIDM modifications

• Handle null feeders of ConnectablePosition in TopologyModificationUtils methods (#2375)
• Allow to create feeder bays in a bus-breaker voltage level (#2355)
• Move method returning feeder by connectable in TopologyModificationUtils from pypowsybl (#2284)

Loadflow

• Replace noGeneratorReactiveLimits by reactiveLimits in LoadFlowParameters (#2414)

Parameters

• Full description of loadflow specific parameters and add integer parameters (#2431)

PSS/E

• Admit special characters (#2397)
• Allow transformers with Zero NomV when cm is set to 2 and when cw is set to 3. (#2400)
• Do not consider isolated buses with type 3 as slacks (#2399)
• Parallel Two Terminal DC between the same AC Buses (#2407)
• Switched Shunt Data, Define voltage control only when MODSW = 1 or 2. (#2411)

PowerFactory

• DGS export configuration doc (#2427)
• Prepare for DGS 6 and 7 support (#2430)
• Add slack extension (#2424)

Scalable

• Fix proportional scaling with constant power factor (#2453)

Security Analysis

• Security Analysis Result: component count, loss of load/generation/elements (#2413)
• Use contingency context in operator strategies (#2429)
• Add actions on tap changers (#2369)

Sensitivity Analysis

• Index sensitivity values by variable type (#2379)

ShortCircuit

• Add status to shortcircuit result (#2356)

Simulations

• Add findAll convenient method to all providers (#2432)

TripleStore

• Refactoring: create TripleStoreUtils with method to query catalog (used in post processors) (#2382)

UCTE

• UCTE import: support of mixed ratio and phase tap changers (#2326)
• Fix UCTE importer conventions of PST active power flow regulation (#2410)

Quality

• Fix vulnerability [CVE-2022-41854] by bumping snakeyaml to 1.33 (#2378)
• Remove test jars usage (#2370)
• Create CgmesCatalogsConstants to decrease code smells (#2392)
• Add docker based local computation manager test utilities (#2391)
• Update GraphViz library (#2451)
• Fix vulnerabilities: (#2419)
  • [CWE-379] Creation of Temporary File in Directory with Incorrect Permissions: bump guava to 31.1-jre
  • [CWE-20] Improper Input Validation: bump rdf4j to 4.2.2
  • [CWE-611] Improper Restriction of XML External Entity Reference ('XXE'): bump poi to 5.2.3
  • [CWE-400] Uncontrolled Resource Consumption ('Resource Exhaustion'): bump jackson to 2.14.1

v5.1.0-RC1

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

Release notes

CGMES

• Import ignored ACLineSegment linked to boundary as dangling lines (#2393)
• If two dangling lines with the same Xnode are in the same geographical region in a CGMES file, they are not merged (#2389)
• Import/Export CGMES Profiles IDs if present (EQ, TP, SSH, EQ_BD and TP_BD) (#2376)
• Fix SVC bMin/bMax during CGMES if capacitive and/or inductive rating are undefined or 0 (#2420)
• CGMES importer: handle GeographicalRegion in BoundarySet (#2426)
• CGMES SV export: use naming strategy to obtain proper topological node identifiers from buses (#2438)

Contingency

• Add battery contingency element (#2366)
• ContingencyBuilder add identifiable (#2396)
• Add bus contingency (#2416)

DataSource

• Compression - support zstd and xz formats (#2409)

Dynamic Simulation

• Add InputStream constructor to curve and event models suppliers #2395

IIDM

• Boundary implementation: get voltage level of network side (#2345)
• Feeders' names in ConnectablePosition are optional (#2385)
• Active Power Control extension: add participationFactor (#2402)
• NetworkStateComparator: added three windings transformers comparison (#2415)
• Default values for network element adders (#2417)
• Implement new consistent behavior when calling merge method (uniform in NetworkImpl, MergingView and CGM import) (#2394)
• CGMES: convert cim:GeneratingUnit.normalPF to ActivePowerControl iIDM extension (#2435)
• Add secondary voltage control IIDM extension (#2436)
• Allow reduction of HVDC lines (#2434)
• Bbv cache not invalidated for a retained switch when opened/closed (#2439)
• Add a new network to test security analysis (#2418)

IIDM modifications

• Handle null feeders of ConnectablePosition in TopologyModificationUtils methods (#2375)
• Allow to create feeder bays in a bus-breaker voltage level (#2355)
• Move method returning feeder by connectable in TopologyModificationUtils from pypowsybl (#2284)

Loadflow

• Replace noGeneratorReactiveLimits by reactiveLimits in LoadFlowParameters (#2414)

Parameters

• Full description of loadflow specific parameters and add integer parameters (#2431)

PSS/E

• Admit special characters (#2397)
• Allow transformers with Zero NomV when cm is set to 2 and when cw is set to 3. (#2400)
• Do not consider isolated buses with type 3 as slacks (#2399)
• Parallel Two Terminal DC between the same AC Buses (#2407)
• Switched Shunt Data, Define voltage control only when MODSW = 1 or 2. (#2411)

PowerFactory

• DGS export configuration doc (#2427)
• Prepare for DGS 6 and 7 support (#2430)
• Add slack extension (#2424)

Security Analysis

• Security Analysis Result: component count, loss of load/generation/elements (#2413)
• Use contingency context in operator strategies (#2429)
• Add actions on tap changers (#2369)

Sensitivity Analysis

• Index sensitivity values by variable type (#2379)

ShortCircuit

• Add status to shortcircuit result (#2356)

Simulations

• Add findAll convenient method to all providers (#2432)

TripleStore

• Refactoring: create TripleStoreUtils with method to query catalog (used in post processors) (#2382)

UCTE

• UCTE import: support of mixed ratio and phase tap changers (#2326)
• Fix UCTE importer conventions of PST active power flow regulation (#2410)

Quality

• Fix vulnerability [CVE-2022-41854] by bumping snakeyaml to 1.33 (#2378)
• Remove test jars usage (#2370)
• Create CgmesCatalogsConstants to decrease code smells (#2392)
• Add docker based local computation manager test utilities (#2391)
• Fix vulnerabilities: (#2419)
  • [CWE-379] Creation of Temporary File in Directory with Incorrect Permissions: bump guava to 31.1-jre
  • [CWE-20] Improper Input Validation: bump rdf4j to 4.2.2
  • [CWE-611] Improper Restriction of XML External Entity Reference ('XXE'): bump poi to 5.2.3
  • [CWE-400] Uncontrolled Resource Consumption ('Resource Exhaustion'): bump jackson to 2.14.1

v4.10.2

Release notes

Fixes

• [Network modification] Fix extension creation in case of no connectables in the voltage level. (#2306)
• Fix loop to get unused positions + refactoring + min is 0, not Integer.MIN_VALUE (#2333)