Release v2.1.1

Release note

GENERAL

• Upgrade powsybl-balances-adjustment

v2.1.0

Release note

GENERAL

• Adaptation of farao to PowSyBl v3.5.0: https://github.com/powsybl/powsybl-core/releases/tag/v3.5.0

CRAC

• The package crac-results-extensions enables to extend the crac object model with complementary information regarding the RAO output.
• The package crac-loopflow-extensions enables to extend the crac object model with complementary information regarding the consideration of loopflows into the RAO
• A Crac constructor following the builder pattern has been added in order to facilitate the construction of the Crac object model
• The frm (Flow Reliability Margin) is a new attribute which have been added to the Cnecs, and which is now subtracted from the Cnecs thresholds during the RAO
• The package crac-io-cne enables to export the crac object model into a CNE .xml file
• It is now possible to specify a timestamp in the crac importer to filter the data
• Switches topology network actions can now be applied on the network

LOOPFLOWS

• A significant new feature of this release is the possibility to monitor, during the RAO, the loopflows on some critical network element, and to ensure that they remain below a threshold defined as the maximum of (i) a threshold defined as input in the crac-loopflow-extensions (ii) the initial loopflow value computed before the application of any remedial action

MNECS

• Another significant new feature of this release is the integration of mnec (Monitored Network Element and Contingency) in the RAO. The margin of the mnec is not optimized. However, the RAO ensures that the margin of those mnecs is (i) positive or (ii) above their initial value.

AMPERE OR MEGAWATT

• A setting of the RAO's configuration gives the possibility to optimize the margin of the Cnecs in Ampere, or in Megawatt. Note than one unit is not just an homothety of the other one, as the margin in ampere tend to give more weights to the lower voltage levels than the margin in megawatt.

AC, DC AND FALLBACK

• The settings of the RAO now enable to define a default and a fallback configuration of the sensitivity computation. It could be typically used to define a default AC configuration, and a DC fallback configuration to prevent the fact that some of the sensitivity computations could diverge.

OTHER RAO FEATURES

• The package rao-commons exposes some "utils" blocks of the RAO, one of them being a cross quality-check of the Crac and Network.
• The node evaluations of the search-tree can now be made in parallel, using several threads of the same machine.
• The logs of the RAO have been made more verbose. The logback framework has been added into the tests in order to facilitate the management of the FARAO's logs.
• The configuration of the RAO (RaoParameters) has significantly evolved since the previous release, with many new parameters and a new organisation of the parameters.
• The RAO can now interact with the systematic sensitivity analysis service provided by PowSyBl

IMPORTANT REMARKS

• As you can see with the content of this release, the code of farao-core is still evolving significantly from one release to the next. Several of those evolutions are impacting, in one way or another, the API of FARAO and consequently the applications that rely on it. We are indeed in a stage in which we are still allowing ourselves to bring many breaking changes to our API (crac-api, rao-api).
• These quick evolutions of the API gives us the flexibility in the current stages of the FARAO development to question some of our initial choices, and adapt some parts of the source in order to make them more robust, scalable, easy-to-read and fitted to the newly developed features.
• Eventually the API of FARAO will be stabilized, and breaking changes will be made with parsimony and be accompanied by more documentation. But this stabilization will come later as some new ground-breaking features are expected in the next release (including the curative remedial actions), and so impacting modification will still be made in the following releases.
• The website of FARAO has been updated since the previous release, with many new pages which describe the algorithms implemented into the RAOs: see https://farao-community.github.io/

v2.0.0

Release note

General

• Powybl upgrade : adapatation of Farao to PowSyBl version 3.2.0
  https://github.com/powsybl/powsybl-core/releases/tag/v3.2.0

Crac API
A new Crac API has been defined. It enables an easier manipulation of network optimization data. It gathers data on states, cnecs and remedial actions. In the end this new Crac API would replace the Crac file API.

Crac io API
Coming with the new Crac API a module that manages import/export of Crac implementations. For now it contains the Crac io API and one implementation of it with JSON format. This new Crac io API is defined according to new PowSyBl way of implementing this kind of interfaces.

Rao API
Following the creation of Crac API which would replace the Crac file API, the Rao API would replace the RA optimization API. It follows the same format as RA optimization API but it uses Crac API as input and not Crac file API. The inputs are mainly a PowSyBl network and a Crac API.

Linear Rao
Linear Rao is one implementation of the new Rao API. Given a network it defines the optimal tap positions of PSTs in preventive state, the one which maximizes the minimum margin. It is based on or-tools engine for linear optimization.

Search Tree Rao
Search Tree Rao is another implementation of the new Rao API. It looks for a good combination of topological remedial actions, and relies on the Linear Rao to optimize the application of PST remedial actions.

Systematic Sensitivity Analysis
The util package of Farao now offers a systematic sensitivity analysis. It is a wrapper arround the already existing sensitivity analysis which also takes as input a Crac, and which performs sensitivity analyses for the several states defined in the Crac.

Additional remarks
Farao will continue to significantly evolve in the next months. For now the documentation on Farao is not evolving as fast as its development. However, its website will be updated in the following weeks and more communication will be made about the new Farao features once the new Crac API and RAOs will start to stabilize (second semester of 2020).

v1.2.0

Release note

General

• Powybl upgrade : adapatation of Farao to PowSyBl version 3.0.0
  https://github.com/powsybl/powsybl-core/releases/tag/v3.0.0

Crac file API

• addition of field penaltyCost for PstElement
• addition of field targetPower for RedispatchingRemedialActionElement

PTDF computation (new feature)

• Calculation of PTDFs is now possible with Farao
• Export of PTDF results in csv format

RA Optimisation API

• addition of topological actions in RaoComputationResults

Closed Optimisation RAO

• switch contingencies are now taken into account
• several redispatch RA on the same generator can now be handle without bug
• addition of BranchOverloadVariablesFiller, MinimizationObjectiveFiller and OverloadPenaltyCostFiller
• addition of overload-penalty-cost in the configuration
• addition of optimisation stop criteria in the configuration : max-time-in-seconds and relative-mip-gap
• deletion of referenceFlowsPreProcessor, now calculated more efficiently in SensitivityPreProcessor
• addition of threshold in the configuration, under which sensitivities are considered null : redispatching-sensitivity-threshold and pst-sensitivity-threshold

To benefit from the new features of the closed optimisation RAO, Farao configuration file should be updated with (e.g.) :

closed-optimisation-rao-parameters:
relative-mip-gap: 0.001
max-time-in-seconds: 36000
redispatching-sensitivity-threshold: 0.05
pst-sensitivity-threshold: 1
overload-penalty-cost: 3000
problem-fillers:
- com.farao_community.farao.closed_optimisation_rao.fillers.BranchOverloadVariablesFiller
- com.farao_community.farao.closed_optimisation_rao.fillers.MinimizationObjectiveFiller
- com.farao_community.farao.closed_optimisation_rao.fillers.OverloadPenaltyCostFiller

v1.1.0

Release note

Features

• Add curative PST and RD optimisation to closed RAO algorithm
• Add CRAC file merging feature

Fixes

• Small fixes in CRAC XLSX import
• Code coverage improvements

v1.0.2

Release note

Fixes

• Fixes some bugs in XLSX CRAC file import

Updates

• Update PowSyBl version to 2.6.0

v1.0.1

Release note

Corrective release.

Fixes

• Update PowSyBl versions to solve some runtime errors observed in FARAO
• Fixes the issue that forced to name CRAC files "cracData" to be used by scripts

v1.0.0

Release note

First official release of farao-core. Below is a big picture of what is available in this initial version.

Data management

• Power system network import in XIIDM, UCTE and CGMES format
• Power system network export in XIIDM format
• CRAC import in XLSX and JSON format
• CRAC export in JSON format

Computation cores

• Initial version of closed optimisation RAO engine
• Prototype of flow decomposition engine
• Prototype of Flowbased computation engine