v6.0.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
IIDM
- Switch flows: fix non-deterministic behaviour (#2615)
- Delete Merging View implementation (#2612)
- Tie line: improve remove method with the possibility to update
P0
andQ0
(#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)
- 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)
- 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
toTrue
. - 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
toTrue
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
- Scaling parameter
iterative
deprecated and replaced by the enumpriority
- New Scaling parameter:
scalingType
. It can be eitherTARGET_P
(the scaling value specified is the target to reach) orDELTA_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
Quality
- Clean some deprecated methods (#2611) and sensitivity function types (#2705)
- 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 initools-packager
(#2614) - Upgrade all runtime dependencies to the most recent version (#2704)
Utilities
CI
- Add a new branch name pattern for full Sonar analyses (#2656)