v1.15.1

📜 Release notes

This is a patch release of v1.15.0

Dependencies

• Bump powsybl-core to v6.7.1 (#1229)

Fixes

• Fix double slack distribution in DC Security Analysis (#1209)

v1.15.0

Labels correspond the associated described change.*

• indicates that some methods were deprecated;
• indicates a breaking change which could impact all users;
• indicates a change in the simulation results that may affect existing tests in your application;
• indicates a new parameter, a new parameter default or a new parameter usage;

📜 Release notes

Documentation

• Enable download of documentation in pdf format (#1149) enables to download the doc in PDF format (from the button at the lower right corner of the documentation page https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/ ). Diagrams and pictures are not yet included in the PDF documentation.
• Add documentation to list the currently implemented security analysis (#1166) documents the remedial actions supported by OpenLoadFlow security analysis (https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/security/inputs.html)
• Fix doc for newtonRaphsonStoppingCriteriaType=UNIFORM_CRITERIA (#1175)
• Advanced programming guide added by #1155 . The advanced programming guide is available at https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/advanced_programming/index.html

Usability

• Clearer error message when initial LF fails in AC Sensi (#1170)
• Improve log and report when max outerloop iterations reached (#1179)
• Reports improved for multi-thread security analysis (#1168). They now appear in the same way whether computation is single threaded or multi-threaded. In addition reports contain information about operator strategy actions that could not be applied to a particular contingency.
• The generators configured to control voltage that reached their reactive diagram limits or local voltage limits during loadflow computation are now reported (#1182). This can help identify causes for large number of outerloop iterations or understand why some groups are not maintaining voltage in the solution.

Security Analysis

• For Security Analysis it is possible to override some loadflow parameters for specific contingencies via a Contingency extension (#1139 and #1156). For more information see 'Contingency Load Flow Parameters' in the Open Load Flow security analysis documentation documentation https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/security/parameters.html
• The violation location is now reported with node information in Node Breaker topology, even when a contingency changes the merged buses ( #1180)
• The AreaInterchangeTargetAction is now supported (#1172 and #1186)
• In Fast DC security analysis, HVDC emulation is disabled (#1173). The active power set point is used instead for HVDC lines configured with AC emulation. Previously, fast DC could give incorrect results if the model contained HVDC lines configured with AC emulation.

Sensitivity Analysis

• Support more voltage sensitivities cases (#1181). For a list of sensitivity supported on OpenLoadFlow see https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/sensitivity/getting_started.html
• Support ThreeWindingsTransformer in DC sensibility analysis (#1190)

Robustness and accuracy

• Fix injections ignored on first slack bus when using multiple slacks (#1160) Completes the fix on multi-slack made in V14.0. . May impact the result of models using multiple slack buses that were subject to this bug. With this fix loadflow runs are expected to provide the same result -after slack distribution- whether they are run with one or several slack nodes. (but before slack distribution the loss depends on the slack location).
• Fix secondary voltage control in case of generator remote voltage control (#1165). Secondary Voltage Control is an optional outerloop, not activated by default, that provides a fast, static, approximation of the equilibrium state of the generator reactive power alignment process that controls the voltage of a remote pilot point.
• Operator strategies are now supported when Security Analysis is performed in multi-thread mode (#1177)
• A new parameter forceTargetQInReactiveLimits can be used to force generator targetQ to be within the generator's reactive limits (#1154). By default the parameter is set to false and, as in previous versions, if targetQ is outside the reactive limits diagram, targetQ is used for a group that is not controlling voltage.
• Slack distribution participation factors: use maxP instead of maxTargetP (#1178 (comment)) (#1178) . May change test results for models that have an ActivePowerControl with a maxTargetP value that overrides a generator's maxP.
• Unrealistic voltage check is now performed for all AC solvers #1188 . Previously the check was only performed for the NewtonRaphson AC Solver. The minRealisticVoltage and maxRealisticVoltage parameters now have an effect for any AC Solver (NewtonRaphson, NewtonKrylov or custom solver)
• The new parameter disableInconsistentVoltageControl can be set so that Open Load Flow disables inconsistent generator voltage controls #1185 . By default, Open Load Flow will continue to keep the voltage control of an inconsistent bus, with one arbitrary configuration from the conflicting set on the bus.
• Reduce unrealistic voltage created by remote voltage control by #1135 via a new parameter, voltageRemoteControlRobustMode set to True by default. . For more information, see the parameter documentation at https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/loadflow/parameters.html . Models that previously failed with unrealistic voltage may now succeed since voltageRemoteControlRobustMode is true by default.
• Balance type PROPORTIONAL_TO_REMAINING_MARGIN checks active mismatch sign for participation factors [#1189]. Previously the margin vs pMax was always taken into account even when the slack mismatch was negative. may change the results of test using the PROPORTIONAL_TO_REMAINING_MARGIN balance type.

Advanced API

• An ordered list of outerloops, which advanced users could specify in AC, can now also be specified in DC (#1159) via the outerLoopNames parameter. For more information see the documentation of the outerLoopNames parameter at https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/loadflow/parameters.html .
• Security Analysis: custom redistribution of injections lost by the contingency can be specified by a plugin (#1155). See the new Advanced Programming Guide for more details https://powsybl.readthedocs.io/projects/powsybl-open-loadflow/en/latest/advanced_programming/index.html
• A library can provide a LoadFlowDefaultParametersLoader that defines default loadflow values including default OpenLoadFLow parameters.(#1176).

Performance

• Fix performance issue when accessing loading limits from IIDM (#1162) makes the access to load limits more efficient and accelerates slightly the AC, DC and fast DC security analysis.
• Load active power target caching (#1163) accelerates slightly fast DC security analysis. This PR changes the order of some double operations at may create small differences in the last bits...

v1.14.1

📜 Release notes

This is a patch release of v1.14.0

Fixes

• Fix javadoc warnings (#1152)
• Fix slack distribution outerloop incorrect stable status (#1157)

v1.14.0

Labels correspond the associated described change.*

• indicates that some methods were deprecated;
• indicates a breaking change which could impact all users;
• indicates a change in the simulation results that may affect existing tests in your application;
• indicates a new parameter, a new parameter default or a new parameter usage;

📜 Release notes

Reports

• Report buses out of realistic voltage range in sub reports [#1105] May change reference reports layout for tests having this error condition.

LoadFlow

• The Area Interchange control is now available in DC [#1123]. Before it was only available in AC. This features, activated by the parameter areaInterchangeControl constrains OpenLoadFlow to find a solution where area interchanges match the input target interchange values. The areaInterchangeControl parameter now impacts DC computations.

Security Analysis

• ViolationLocation are now returned for bus voltage violations. ViolationLocation allow to know the precise location of a bus related violation inside a VoltageLevel, in BusBreaker topology or in NodeBreakerTopology. [#1134]
• The criteria to stop the active power flow through a disconnected HVDC line has been modified in [#1120]. Previously an HVDC line was considered disconnected if one of its stations was connected to an isolated merged bus that was not connected to a Generator or a Load. With this fix, fictive loads are ignored. So if an HVDC station is only connected to a fictive load, the HVDC line is now considered disconnected.
• With parameter connectedComponentMode set to ALL, the security analysis now handles correctly all synchronous components of the main connected component (#1129). Previously, only the largest synchronous component of the main connected component was run. . May impact tests running SA on all components where the first connected component has several synchronous parts.
• PST actions for fast DC SA are supported [#1095]. Fast DC SA is an optional algorithm for security analysis in DC activate by the dcFastMode parameter. It is much faster than the default algorithm but has currently some limitations (see the dcFastMode parameter documentation for a list of limitations)

Robustness and accuracy

• Retry LU decomposition if incremental mode fails (#1108). This change helps in particular for the SA computation of large modes with HVDC in AC emulation that can reach or quit the maximal HVDC Active Power Range.
• Fix injections ignored on slack buses when using multi slack (#1116) . May impact the result of models using multiple slack buses that were subject this this bug.
• DC Load Flow reference bus and multi slack support [#1118]. Provides a better DC initialization for AC simulations using multiple slack buses.
• Fixed a bug in DC : incorrect transit if a PST is near zero impedance lines, or if a HVDC in AC emulation is near a zero impedance line. FIxed by #1138. May change results of tests that were subject to the bug
• In DC, the slackDistributionFailureBehavior parameter is now honoured [#1146]. Previously the behaviour was always LEAVE_ON_SLACK_BUS even if the parameter had a different value. Tests with a different value than LEAVE_ON_SLACK_BUS and a slack distribution failure condition may behave differently with this release.

Advanced API

• An extension API is provided to allow external AC Solvers in addition to the existing NewtonRaphson and NewtonKrylov solvers (#1107). The acSolverType has evolved to support other AC solvers available in the classpath.
• The utility class com.powsybl.openloadflow.util.MatrixUtil has been removed and the utility functions added to the com.powsybl.math.matrix.DenseMatrix class from powsybl-core [#1136]. This may break code of projets that took advantage of this internal utility class.

v1.13.2

Release notes

Dependencies

• Bump powsybl-core to 6.5.1 (#1110)

Fixes

• Fix Security Analysis in case of no more voltage regulated bus (#1096)
• Fix high memory usage with DC Sensitivity Analysis and DC Woodbury Security Analysis (#1109)

v1.13.1

Release notes

• Fix secondary voltage control in case of generators with remote volage control (#1103)

v1.13.0

Release notes

Update to PowSyBl Core 6.5.0 (#1094, #1100)

Features

• Remove grouping by element necessary to connectivity (#1060)
• Support of Hvdc line loss in AC emulation (#1062)
• DC sensitivity analysis: remove factors in connectivity break analysis (#1073)
• Add category keys to Parameters (#1071)
• Multi-thread security analysis (#1079)
• Fast restart for active power target change (#1085)
• Avoid slack distribution to fictitious loads (#1028)
• Fast DC security analysis using Woodbury engine (#1072)
• Security analysis: run simulation on all components (#1089)
• Add transformer voltage control already exists report in LfNetworkLoaderImpl (#1088)
• Area Interchange Control as OuterLoop (#1055)
• Retrieve specific parameters overrides from PlatformConfig (#1093)

Fixes

• Fix log for switching PQ to PV (#1067)
• At most one flow/factor states calculation for one contingency in DC sensitivity analysis (#1061)
• Security Analysis: fix Generator initialTargetP in OperatorStrategies (#1069)
• AC loadflow: no network update on NO_CALCULATION (#1075)
• Fix LimitViolation data for three-windings transformers (#1076)
• Fix StaticVarCompensator and VscConverter used as reference generator (#1078)
• Fix slack distribution when reference generator is not participating element (#1084)
• Fix unpaired DanglingLine simulated with split shunt admittance (#1098)
• Fix SA exception "No slack bus for network" (#1097)

Quality

• Extract Woodbury engine from DC sensitivity analysis (#1064)
• Remove log.txt (#1066)
• Move runDcLoadFlow from DC sensitivity analysis to DcLoadFlowEngine (#1082)
• Move cleanContingencies from DC sensitivity analysis to PropagatedContingency utility method (#1081)

Documentation

• Add styles for docs (#1065)
• Add dark mode pi model (#1077)
• Fix dead links in README.md (#1083)
• Add documentation for HVDC lines (#1070)

v1.12.2

Release notes

• Bump powsybl-core to 6.4.1 (#1068)

v1.11.1

Release notes

• Fix bus state for AC calculations (#1058)

v1.12.1

Release notes

Fixes

• Revert "Refactor DC Sensitivity Analysis with Woodbury engine (#1001)" (#1057)
• Fix bus state for AC calculations (#1058)
• Extract ConnectivityBreakAnalysis and ComputedContingencyElement from DcSensitivityAnalysis (#1059)