⚡sting⚡

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

STING is now available on PyPI (https://pypi.org/project/sting-py/)! To get the latest version of STING please install in Editable Mode, rather than through PyPI.

Warning

STING has been packaged under the name sting-py.

To install using pip use:

pip install sting-py

Installing STING in Editable Mode

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
   pip install -e .  
   

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

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.

Installing STING in Project Configuration

For research projects we recommend creating a separate directory for your project files and scripts—isolating them from the source files of STING. To install and configure STING in this manner perform the following steps.

1. Download STING: If you haven't already, install python3.13 and clone STING

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

2. Project Installation: In the same parent directory of STING, create a new directory for your project—for instance my_project. Then install all packages from STING in a virtual environment

   mkdir my_project
   cd my_project
   python3.13 -m venv .venv 
   source .venv/bin/activate
   pip install -e ../sting/.
   

3. Visual Studio Code (Optional): If you are using Visual Studio Code as a text editor you can add STING as an "extra path". To do so go to Preferences > Settings and search for extra paths. Under Python > Analysis: Extra Paths add the global path of STING on your machine—for instance Users/your_name/python/sting.

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	Use
IPOPT	brew install ipopt	ACOPF
Gurobi	pip install gurobipy	Capacity expansion
MOSEK	pip install mosek	Capacity expansion

Important

Please install all relevant solvers for your use case before running STING.

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}
}

Research Software Notice

All work is distributed under the Apache open-source license. However, this repository also contains software developed as part of active research that has not yet been formally published. As a developer, user, or reader of this software you are agreeing to good faith applications of this work. Original research that has not been previously published may not be represented as the independent work of another author. We kindly ask that you adhere to academic integrity and consult with authors if you are unsure what might constitute original unpublished work.