sting-py 0.1.0

Specialized Tool for INverter-based Grids

:zap:sting:zap:

Welcome! This repository contains sting—Specialized Tool for INverter-based Grids. STING is an open-source software that is able to run:

• AC Power Flow
• Stochastic capacity expansion
• Kron reduction
• Large-scale model reduction
• Small-signal modeling
• Electromagnetic simulation

Installation

1. Download STING: Make sure you have python3.13 installed on your computer. Using pyenv can be helpful for managing multiple versions of python on your PC. Start by cloning this repository and navigating into the STING directory.

   $ git clone https://github.com/REAM-lab/sting
   $ cd sting
   

   Next, create a virtual environment and download all required packages.

   $ python3.13 -m venv .venv 
   $ source .venv/bin/activate
   (.venv)$ pip install -e .  
   

To install all optional dependencies, run pip install -e ".[all]". This will install extra packages necessary for optimization solvers, model_reduction, and sting development.

2. Run sting: To ensure that sting was installed correctly navigate to the examples folder. You will see examples for different modules. Find the file run.py and execute it.

Solvers

Most of modules additionally require commercial or open-source solvers to run various optimization models. For example, solving optimal power flow is needed to find an equilibrium point for small-signal modeling. We currently support and use the following libraries

Solver	How to install in your python environment	Use
IPOPT	brew install ipopt + pip install cyipopt	ACOPF
Gurobi	pip install gurobipy	Capacity expansion
MOSEK	pip install mosek	Capacity expansion
SLICOT	pip install slycot + brew install gcc	Model Reduction

Citing

@misc{STING,
    author = {{Renewable Energy + Advanced Mathematics Lab (REAM)}},
    title = {Specialized tool for inverter-based grids},
    year = {2025},
    publisher = {GitHub},
    journal = {GitHub repository},
    url = {https://github.com/REAM-lab/sting}
}