DSSData

⚡A python micro-framework for steady-state simulation and data analysis of electrical distribution systems modeled on OpenDSS.

Mode support: Static and Time-series.

Why DSSData?

The purpose of DSSData is to facilitate the steady-state simulation of modern electrical distribution systems, such as microgrids, smart grids, and smart cities.

With DSSData you can easily make your own super new fancy operation strategies with storage or generators, probabilistic simulation, or simple impact studies of a distributed generator. See an example in our Tutorial.

All you need is your base distribution system modeled in OpenDSS!!!

Easy to simulate

We built the DSSData for you just write what you want in a simple function, plugin on a power flow mode, and run.

You don't need anymore write a routine to run each power flow per time.

Quick Start

Installation

We strongly recommend the use of virtual environments manager.

pip install dssdata

Static Power Flow (Snapshot)

First, comment any solve, output command (e.g: show), or solve configurations (e.g: set mode=Snap) from your .dss file.

NOTE: Any Monitor is needed to get the data.

Supposing that you file is in the path master.dss:

from dssdata import SystemClass
from dssdata.pfmodes import run_static_pf
from dssdata.tools import voltages

distSys = SystemClass(path="master.dss", kV=[13.8, 0.230], loadmult=1.0)

[voltageDataFrame] = run_static_pf(distSys, tools=[voltages.get_all])
print(voltageDataFrame)

Time series Power Flow

First, comment any solve, output command (e.g: show), or solve configurations (e.g: set mode=daily stepsize=5m time=...) from your .dss file.

NOTE: Any Monitor is needed to get the data.

NOTE: The Loadshape must be defined in the .dss file

Supposing that you file is in the path master.dss:

from dssdata import SystemClass
from dssdata.pfmodes import cfg_tspf, run_tspf
from dssdata.tools import lines, voltages

distSys = SystemClass(path="master.dss", kV=[13.8], loadmult=1.2)
cfg_tspf(distSys, step_size="5m", initial_time=(0, 0))

[voltageDataFrame] = run_tspf(distSys, tools=[voltages.get_all], num_steps=288)
print(voltageDataFrame)

Documentation

We provide an full API documentation and examples in the DSSData Documentation.

Citing

If you find DSSData useful in your work, we kindly request that you cite it as below:

@software{Monteiro_felipemarkson_dssdata_2022,
  author = {Monteiro, Felipe},
  doi = {10.5281/zenodo.6784237},
  license = {MIT},
  month = {6},
  title = {{felipemarkson/dssdata}},
  url = {https://github.com/felipemarkson/dssdata},
  year = {2022}
}

Help us to improve DSSData

See our Issue section, our Development Guidelines, and our Code of conduct.

Contributors:

• JonasVil