Open RAO

Open RAO (Remedial Action Optimizer) is an open-source toolbox that aims at providing a modular engine for remedial actions optimisation, part of the Linux Foundation Energy.

powsybl-open-rao repository contains the main features of Open RAO.

For detailed information about Open RAO toolbox, please refer to the detailed documentation.

This project and everyone participating in it is governed by the PowSyBl Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to powsybl-tsc@lists.lfenergy.org.

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

In order to build powsybl-open-rao, you need the following environment available:

• Install JDK (17 or greater),
• Install Maven latest version.

Installing

Before installing powsybl-open-rao, you need to install OR-Tools, a software suite for optimisation that is used by Open RAO.

Please refer to OR-tools website for installation instructions.

Open RAO also needs a load flow implementation and a sensitivity analysis implementation at runtime, following the interfaces of powsybl-core which documentation is available in PowSyBl website. Note that for obvious reasons, included performances, reliability and transparency, Open RAO uses Powsybl Open Load Flow by default, but you can prefer you own implementation.

Running

In order for Open RAO to run without error, you will need to configure your itools platform. itools is a command line interface provided by PowSyBl framework.

Two options are available:

1. First, you can use the one provided by Open RAO. It is saved in the etc directory of the installation, and is called config.yml. You just have to copy-paste it in $HOME/.itools directory. You can also use one of the provided network post-processor scripts saved in the etc directory by copy-pasting them in the same directory and adding these lines to your config.yml file :

import:
  postProcessors: groovyScript

groovy-post-processor:
    script: $HOME/.itools/core-cc-ucte-postProcessor.groovy

2. Expert users can also adapt it to their own needs.

For using itools, enter on the command line:

cd <install-prefix>/bin
./itools help

For more information about itools, do not hesitate to visit PowSyBl documentation.

License

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE.txt file for details.