Distribution System Simulator based on OpenDSS

OpenDSS, pint, DSS, circuit-simulation, electrical-engineering, powerflow, smart-grid
pip install krangpower==0.2.4


Documentation Status Build Status codecov Latest Version


Distribution System Simulator based on OpenDSS and OpenDSSDirect.py. Modern Syntax, DataFrames, Pint, Networkx.

Design goals

  • Providing an even easier and more intuitive frontend
  • Introducing measurement units through the package pint, allowing the user to worry less about errors, to delegate the burden of conversion and to correctly interpret the results without recurring to the OpenDSS docs
  • Returning results in interoperable data structures and containers
  • Enabling advanced analysis modes, for example:
    • Exporting the network topology in a networkx graph
    • Solving duty cycles that involve smart components that need to update themselves every n steps
  • Providing a I/O facility based on zip packages and JSON files, allowing easier bookkeping and search and procedural generation of circuits with custom tools
  • And many more!


The documentation for krangpower is available here.

Python version

Krangpower is a python 3.x package; currently, compatibility with python 2.x is not sought after.


The authors would like to thank the Swiss Federal Office of Energy (SFOE) and the Swiss Competence Center for Energy Research - Future Swiss Electrical Infrastructure (SCCER-FURIES), for their financial and technical support to this research work.