Skip to content
STEPSS

PyRAMSES Installation

PyRAMSES (Python-based RApid Multithreaded Simulation of Electric power Systems) is a time-domain dynamic simulator for electric power systems. It provides a Python interface to the RAMSES simulation engine, enabling users to define test cases, run simulations, extract results, and perform post-processing—all within Python scripts or Jupyter notebooks.

PyRAMSES supports both Windows and Linux operating systems and integrates with standard scientific Python libraries (NumPy, SciPy, Matplotlib).

Installation

Section titled “Installation”

Install PyRAMSES and all recommended dependencies via pip:

Terminal window
pip install matplotlib scipy numpy mkl jupyter ipython pyramses

For a minimal installation (no plotting or notebook support):

Terminal window
pip install pyramses

MKL Dependencies

Section titled “MKL Dependencies”

The simulator depends on the Intel Math Kernel Library (MKL) for LAPACK/BLAS and OpenMP. These are automatically installed as dependencies when installing via pip.

To verify MKL is available, run:

Terminal window
python -c "import numpy; numpy.show_config()"

Look for blas_mkl_info or lapack_mkl_info in the output confirming MKL is linked.

Optional: Gnuplot for Real-Time Plots

Section titled “Optional: Gnuplot for Real-Time Plots”

PyRAMSES can display observables in real-time during simulation using Gnuplot. This is particularly useful for long simulations to monitor progress.

Terminal window
sudo apt-get install gnuplot-x11

Platform Support

Section titled “Platform Support”
PlatformLibraryNotes
Windowsramses.dllPrimary platform, full support
Linuxramses.soFull support with gfortran/OpenBLAS

Next Steps

Section titled “Next Steps”