Skip to content

v6.0.0

Compare
Choose a tag to compare
@annetill annetill released this 28 Sep 12:17
· 411 commits to main since this release
v6.0.0
e95272e

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

Release notes

IIDM

  • Switch flows: fix non-deterministic behaviour (#2615)
  • Delete Merging View implementation (#2612) Breaking Change
  • Tie line: improve remove method with the possibility to update P0 and Q0 (#2647)
  • Network modifications : implement RemoveSubstation (#2637)
  • Add a utility method to find the optional other side dangling line (#2680)
  • Remove dangling lines merge by ID (#2677)
  • Check minimumValidationLevel coherence before merging networks + update validationLevel (#2662)
  • Traversal from terminal by depth or breadth first (#2626) Breaking Change
  • Add getBusCount() to network and voltage level bus/breaker topology for symmetry (#2660)
  • Added generator remote reactive power control iIDM extension XML serialization (#2694)
  • Fix terminal ref to a tie line (#2719)
  • ThreeSides to integer conversion helper in enum (#2721)

IIDM v1.11

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

  • Write properties for calculated buses in iidm export (#2631)
  • Voltage angle limit (#2657)
  • Subnetworks (#2442, #2678, #2718) Breaking Change
  • Rename dangling line ucteXnodeCode to pairingKey (#2676)

CGMES

  • Add possible values to naming strategies at CGMES import (#2609)
  • Fix handling of T-Point during CGMES Bus-Branch import (#2610)
  • Implement a pre-processor that completes the CGMES model with missing containers before starting the conversion (#2463)
  • Fix StateVariableExport following branch changes (#2621)
  • Remove CGMES properties and aliases from tie lines: keep mapping data in dangling lines (#2575)
  • CGMES export: improve default ratedS value (#2598)
  • CGMES export: loads with negative p0 as EnergySource (#2627)
  • CGMES export: add new parameter to make ModelDescription custom (#2628)
  • CGMES import: fix ensure unicity for switches (#2653)
  • CGMES export: transformers with sorted ends (#2644), set new parameter iidm.export.cgmes.export-transformers-with-highest-voltage-at-end1 to True.
  • CGMES import: switches may not have a name attribute (#2691)
  • CGMES export: fix SV export phase and ratio tap changer if both present (#2685 and #2693)
  • CGMES import: support of optional ratedS value of transformers (#2648)
  • CGMES export: support of equivalent shunts in EQ, SSH, SV (#2673)
  • CGMES export: use region and base voltage references from boundaries (#2618), set new parameter iidm.export.cgmes.sourcing-actor to override the research of the sourcing actor using the network country.
  • CGMES export: updated control area, label as superseding for SSH (#2699)
  • CGMES export: switch type and alias type for terminals of dangling lines (#2709)
  • CGMES export using subnetworks for SSH, EQ and TP profiles by TSO (#2663 and #2711)
  • CGMES force import of node/breaker as bus/breaker (#2717), set new parameter iidm.import.cgmes.import-node-breaker-as-bus-breaker to True to force a node/breaker model to be imported as bus/breaker (TP instance file is required).

UCTE

  • Improve error message for lines between 2 Xnodes (#2682)

Network modification

  • Scalable: if equipment is disconnected, then it is not scaled (#2605)
  • Fix post-removal equipment access (#2620)
  • Invalid components after dangling lines merging and tie lines removal (#2623)
  • Battery modification (#2625)
  • Topology cleanup used in RemoveFeederBay was not checking if Connectables were connected to successive nodes in mixed branches (#2629)
  • Add a substation removal modification (#2637)
  • When connecting a generator or a shunt in regulation mode, consider regulating terminals to compute targetV (#2655)
  • Handling updown scalable get steady state power (#2710)

Scaling modifications (#2666)

  • Floats changed to doubles in the methods and constructors Breaking Change
  • Scaling parameter iterative deprecated and replaced by the enum priority Deprecated
  • New Scaling parameter: scalingType. It can be either TARGET_P (the scaling value specified is the target to reach) or DELTA_P (the scaling value specified is the difference to reach with the steady state value).
  • Add the possibility to create a ProportionalScalable from a list of injections and a distribution mode. This example shows a proportional scaling on two loads and a dangline line:
List<Injection<?>> injectionsList = Arrays.asList(network.getLoad("l1"), network.getLoad("l2"), network.getDanglingLine("dl1"));
ScalingParameters scalingParametersProportional = new ScalingParameters(Scalable.ScalingConvention.LOAD,
            true, true, RESPECT_OF_VOLUME_ASKED, true, DELTA_P);
ProportionalScalable proportionalScalable = Scalable.proportional(injectionsList, PROPORTIONAL_TO_P0);
double variationDone = proportionalScalable.scale(network, 100.0, scalingParametersProportional);
  • Add the possibility to create a StackScalable from a list of injections.

Matpower

  • Fix non regulating generators connected PV buses (#2639)
  • Matpower bus names params (#2642)
  • Matpower export: fix nan in targetQ (#2695)
  • Limits export (#2665)
  • Add log for generators converted to a load (#2712)

IEEE CDF

  • Fix IEEE 118 nominal voltages (#2708)

Security analysis

  • Support of static var compensator action (#2654)
  • Operator strategy as a list of conditional actions (#2635)

Short-circuit analysis

  • Make the method toThreePhaseValue public in FortescueValue (#2670)

New parameters (#2638)

See new config.yml example:

  sub-transient-coefficient: 0.8 # in the case of a sub transient study, an optional coefficient by which the transient reactance of the generators is multiplied in order to obtain the sub transient reactance. This coefficient should be less than 1.
  with-loads: true # if set to true means that loads are taken into account in the short-circuit calculation by using P0 and Q0 to retrieve the short-circuit feeding. If set to false, all loads are considered with P0 and Q0 equal to zero.
  with-shunt-compensators: true # if set to true means that shunt compensators feeding is taken into account. P and Q are used to retrieve the short-circuit feeding. False means no feeding.
  with-vsc-converter-stations: false #  if set to true, VSC converter stations are modeled as equivalent reactances, if set to false, they are ignored.
  with-neutral-position: true # for tap changers only. If false, the step defined in the network model is used, else the neutral step is used (rho = 1, alpha = 0).
  initial-voltage-profile-mode: "CONFIGURED" # NOMINAL, CONFIGURED or PREVIOUS_VALUE.
  voltage-ranges: "config/voltage-ranges.json" # the path to a JSON file containing a list of voltage ranges with associated coefficients to be applied to each nominal voltage in the range to get the initial voltage profile. To use if initial-voltage-profile-mode is set to CONFIGURED.

An example of the JSON file containing the voltage ranges and associated coefficients is:

[
    {
      "minimumNominalVoltage": 350.0, 
      "maximumNominalVoltage": 400.0,
      "voltageRangeCoefficient": 1.1 // this coefficient should be between 0.8 and 1.2
    },
    {
      "minimumNominalVoltage": 215.0,
      "maximumNominalVoltage": 235.0,
      "voltageRangeCoefficient": 1.2
    },
    {
      "minimumNominalVoltage": 80.0,
      "maximumNominalVoltage": 150.0,
      "voltageRangeCoefficient": 1.05
    }
]

Math

  • Check dense matrix max element count at creation (#2669)

AMPL

  • Ampl executor - Change parameters file IO streams (#2608)

Dynamic simulation

  • Add command to list dynamic models and event models (#2674)

Compatibility

  • PowSyBl-Core now only supports Java 17 and higher (#2617, #2659) Breaking Change

Quality

  • Clean some deprecated methods (#2611) and sensitivity function types (#2705) Breaking Change
  • Bump guava from 31.1-jre to 32.0.1-jre. Fix CVE-2020-8908 and CVE-2023-2976 (#2616)
  • Add a missing space in logs and report during feeder bay's creation (#2658)
  • Add some tests with a reporter different than NO_OP during network modification applications (#2667)
  • Fix some issues detected by the new Sonar profile (#2671, #2684)
  • Add a scope provided clause for maven-core dependency in itools-packager (#2614)
  • Upgrade all runtime dependencies to the most recent version (#2704) Breaking Change

Utilities

CI

  • Add a new branch name pattern for full Sonar analyses (#2656)