Awesome

Status: Expect regular updates and bug fixes.

Technical support:* support.tdcosim@anl.gov

Utilitiy to perform Co-Simulation of Transmission, and Distribution systems with DER's

TDcoSim (T & D co-simulation tool) is a Python package that can be used to perform co-simulations containing a transmission system simulator (TSS), multiple distribution system simulator (DSS) instances, and multiple solar PV-DER instances. It is capable of both static and dynamic co-simulations for power systems models containing hundreds of transmission buses, distribution feeder nodes, and DER's.

schematic of TDcoSim

Installation

You can install tdcosim by running the following command on command line.

pip install git+https://github.com/tdcosim/TDcoSim.git@master

In the event you do not have git installed on your machine, you can alternatively run the following from command line.

pip install https://github.com/tdcosim/TDcoSim/archive/master.zip

After installation open a new command prompt and run the following to set psse path,

tdcosim setconfig -p "path\to\psse_installation"

For example, something similar to, tdcosim setconfig -p "C:\Program Files\PTI\PSSE35\35.0\PSSPY37"

Dependencies:

External software: PSS®E, OpenDSS
Python packages: pvder, SciPy, Numpy, Matlplotlib, PyWin

Quick start

The config.json file provided in the examples folder can be used to do a co-simulation after editing the path names (with any text editor). Then open a command line prompt and use the following commands to to run a co-simulation. Note that config_td.json could be replaced by the name of any other configuration file.

   tdcosim run -c ".\examples\config_td.json"

To visualize the co-simulation results using the dashboard use the following commands. Note that .\dashboard\vizsample can be replaced with the folder containing the co-simulation results.

   tdcosim dashboard -o ".\dashboard\vizsample"

Detailed documentation on running a co-simulation may be found within the user guide. Additional examples are available here.

Package details

Technical information on the package can be found here:

Issues & Support

Please feel free to raise an issue for bugs or feature requests or reach out to support.tdcosim@anl.gov.

Who is responsible?

Project PI:

Karthikeyan Balasubramaniam kbalasubramaniam@anl.gov (September 2019 to present)

Core developers:

Karthikeyan Balasubramaniam kbalasubramaniam@anl.gov
Sang-il Yim yim@anl.gov

Co-developers:

Siby Jose Plathottam splathottam@anl.gov

Previous contributors:

Ning Kang ning.kang@inl.gov (January 2018 to August 2019)
Rojan Bhattarai rbhattarai@anl.gov

Acknowledgement

We want to acknowledge Shrirang Abhyankar for his contributions to the code base development.

We would like to recognize the support of the EPRI technical team led by Roger Dugan and Davis Montenegro and the use of the EPRI OpenDSS open source software.

This project is supported by Ali Ghassemian and Dan Ton, U.S. DOE Office of Electricity, Advanced Grid Research and Development.

Citation

If you use this code please cite it as:

@misc{TDcoSim,
  title = {Transmission and Distribution System Co-simulation Tool}: A co-simulation utility},
  author = "{Karthikeyan Balasubramaniam, Sang-il Yim, Ning Kang}",
  howpublished = {\url{https://github.com/tdcosim/TDcoSim}},
  url = "https://github.com/tdcosim/TDcoSim",
  year = 2019,
  note = "[Online; accessed 23-August-2019]"
}

Copyright and License

Transmission and Distribution System Co-simulation Tool (TDcoSim) is distributed under the terms of BSD-3 OSS License.