Skip to content

SPS-L/5_bus_test_system

Repository files navigation

PyRAMSES Dynamic Simulation Tutorial - 5-Bus Test System

This repository contains startup material for dynamic simulation studies with PyRAMSES on a 5-bus system. The material is designed for the Control and Operation of Electric Power Systems (EEN452) course at Cyprus University of Technology.

Overview

The assignment focuses on understanding generator and controller behavior during disturbances, and on interpreting dynamic responses (frequency, voltage, rotor angle, and power). The test system includes:

  • One synchronous generator with detailed machine, governor, and AVR models
  • Composite load behavior (impedance and motors)
  • External grid representation for disturbance studies
  • Multiple operating points and disturbance scenarios

Course Context

This material is part of the EEN452 course taught by Dr. Petros Aristidou at the Sustainable Power Systems Lab.

Assignment and Deliverables

The full assignment brief is provided in:

According to the assignment document, students must submit:

  • A report (PDF) addressing all requested case-study questions, or equivalent answers in notebook Markdown cells
  • The working notebook implementation (.ipynb) and all required input files

This assignment contributes 10% of the final grade. Late submissions are penalized according to the assignment rules.

Repository Files

  • Transient Angle.ipynb: Example notebook for transient angle studies
  • Case 2.ipynb: Example notebook implementation for Assignment Case 2
  • dyn.dat: Dynamic model data
  • lf1.dat, lf1solv.dat: Operating point 1 load-flow and solved state
  • lf2.dat, lf2solv.dat: Operating point 2 load-flow and solved state
  • obs.dat: Observable definitions for post-processing
  • solveroptions.dat: Solver and simulation options
  • nothing.dst: Empty disturbance file
  • assignment.pdf: Official assignment handout

Experimental Cases

The assignment defines seven case studies (Cases 1-7), including:

  • Set-point changes (active power and voltage)
  • External system voltage dips
  • Fault-and-clear events on line 1-3
  • Line tripping scenarios
  • Analysis of controllers (governor, AVR, PSS) and load recovery behavior

Use the notebooks as starting points and extend/adapt them to implement all required cases from assignment.pdf.

Getting Started

Prerequisites

  • Access to the course JupyterHub platform, or local JupyterLab
  • PyRAMSES installed and available in the notebook environment
  • Basic familiarity with Python and power system dynamics

Installation (local environment)

pip install matplotlib scipy numpy mkl jupyter ipython pyramses

Running the Simulations

  1. Open this folder in JupyterHub or JupyterLab.
  2. Start with Transient Angle.ipynb or Case 2.ipynb.
  3. Run cells sequentially.
  4. Modify operating point files and disturbances to implement each assignment case.
  5. Plot and comment on the requested observables.

References

Support

For PyRAMSES technical issues, consult the official documentation. For course-related questions, use the course communication channels.


5-bus system one-line diagram

This material is part of the EEN452 course curriculum at Cyprus University of Technology, developed by the Sustainable Power Systems Lab.

About

No description or website provided.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors