Welcome to Grid2Op’s technical documentation!

Grdi2Op is a pythonic, easy to use framework, to be able to develop, train or evaluate performances of “agent” or “controler” that acts on a power grid in different ways.

It is modular and can be use to train reinforcement learning agent or to assess the performance of optimal control algorithm.

It is flexible and allows the power flow to be computed by the algorithm of your choice. It abstracts the modification of a powergrid and use this abstraction to compute the cascading failures resulting from powerlines disconnection for example.


  • abstract the computation of the cascading failures

  • ability to have the same code running with multiple powerflow calculator

  • parallel execution of one ageent on multiple independent scenarios (multiprocessing)

  • fully customisable: this software has been built to be fully customizable to serve different purposes and not only reinforcement learning, or the L2RPN competition.

Plotting capabilities

Main Exceptions

If you still can’t find what you’re looking for, try in one of the following pages: