Dynawo Replay is a tool for running dynamic power grid simulations using Dynawo without predefining export variables. This allows users to extract additional variables afterward without re-running the entire simulation.
The methodology involves executing a global simulation while extracting only a minimal set of variables (curves). These are then used to recreate any desired variables via a local replay. In simplified terms, the simulation exports voltage and frequency at connection points of dynamic models (generators). The local replay then consists of a mini-simulation where the generator is connected to an infinite bus with voltage and frequency set to the extracted values from the global simulation.
This tool is developed as a Python package. It can be installed using any pip-based installer. We recommend using pipx or uv to avoid dependency conflicts:
uv tool install git+https://github.com/dynawo/dynawo-replay-AIAFor analytical purposes, install the following version:
uv tool install git+https://github.com/dynawo/dynawo-replay-AIA[analytics]But, of course, you can always go with plain pip:
pip install git+https://github.com/dynawo/dynawo-replay-AIAVerify the installation with:
dynawo-replay --helpNote: This package relies on Dynawo, which must be installed separately. See Dynawo installation docs.
The methodology consists of two main steps: case preparation and replay.
The path to the Dynawo package used for running simulations is configured through the environment variable DYNAWO_HOME, which defaults to ~/dynawo/, but can be overridden via command-line options (see --help for each package command).
Other settings can also be configured via environment variables. See src/dynawo_replay/config.py for a complete list.
Run the global simulation while storing necessary data for later curve reconstruction using the prepare command. Given a Dynawo case located in case/, run:
dynawo-replay prepare case/This executes the simulation using Dynawo as defined in case/, exporting minimal variables and saving all required replay information in case/replay/.
Reconstruct curves via a local replay. Provide the case folder, model ID, and the list of variables to be reconstructed using the replay command. For example:
dynawo-replay replay ./IEEE57_GeneratorDisconnection/ GEN____6_SM generator_iStatorPu_im generator_iStatorPu_reFor further details, use the --help option on any command.