STEPSS

Umbrella repository for the STEPSS power system simulation platform.

This repository pulls in every component of the STEPSS power system simulation platform from the SPS-L organization as a git submodule, each tracking its default branch.

Components

Submodule	Access	Description
stepss-ramses	private	RAMSES dynamic power system simulator (core engine)
stepss-uramses	public	User-defined device models framework (custom Fortran model compilation)
stepss-python-ui	public	Python API/wrapper for RAMSES, published as the stepss PyPI package
stepss-java-ui	public	Java-based GUI front-end
stepss-helios	private	Modern C++ power-flow engine (successor to PFC; TUI + C API)
stepss-pfc	private	Power flow computation
stepss-Codegen	private	CODEGEN model code generation
stepss-cg-studio	public	Visual block diagram editor for CODEGEN models
stepss-dyngraph	private	Post-processing tool for extracting and plotting RAMSES simulation curves
stepss-eigenanalysis	public	Small-signal / eigenvalue analysis tools (MATLAB)
stepss-RamsesNN	public	Neural networks embedded in dynamic power system simulators
stepss-docs	public	Documentation website (Astro/Starlight)
stepss-userguide	public	LaTeX user documentation and models reference
stepss-license-gen	private	License generation tooling for STEPSS components
stepss-test-systems	private	Power system test cases and network models

Getting everything

git clone --recurse-submodules [email protected]:SPS-L/stepss.git

or over HTTPS:

git clone --recurse-submodules https://github.com/SPS-L/stepss.git

Submodule URLs are relative, so they use the same protocol you cloned the umbrella with. Private components require access to the SPS-L organization; without it they simply fail to fetch; initialize just the public ones with:

git submodule update --init stepss-uramses stepss-python-ui \
  stepss-java-ui stepss-cg-studio stepss-eigenanalysis stepss-RamsesNN \
  stepss-docs stepss-userguide

Updating to the latest components

Each submodule tracks its default branch. To move everything to the latest tips:

./update.sh

then review and commit the bumped submodule pointers:

git commit -am "Update components to latest"
git push

If you already cloned and someone else bumped the pointers:

git pull
git submodule update --init --recursive

Documentation

Platform-wide documentation lives at stepss.sps-lab.org. Each component repository carries its own README with build and usage instructions.

License

This umbrella repository contains only submodule pointers and helper scripts. Each component is licensed individually. See the LICENSE file in each component repository (a mix of Apache-2.0, MIT, CC BY 4.0, and the STEPSS Academic Public License; private components are internal to SPS-L).

Authors

Developed and maintained by the Sustainable Power Systems Laboratory (SPS-L) at the Cyprus University of Technology, under the direction of Dr. Petros Aristidou.