patelshyamal / tdcosim

T&D co-simulation package

Status: Expect regular updates and bug fixes.

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

The T&D co-simulation tool is a Python module 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 performaing both both static and dynamic co-simulations for power systems models containing hundreds of transmission buses, distribution feeder nodes, and DER's.

Links

• Source code repository: https://github.com/tdcosim/TDcoSim
• User guide: Markdown, PDF
• API Documentation: API doc

Installation

You can install the module directly from github with following commands:

    git clone https://github.com/tdcosim/TDcoSim.git
    cd
    pip install -e .

Dependencies:

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

Quick start

The config.json file provided in the repository can be used to do a co-simulation after editing in the path names (with any text editor). Then open a command line prompt within the folder containing the tdcosimapp.py file (for e.g. by typing Shift+C+M+D) and run the following script to start the co-simulation.

python tdcosimapp.py > log_file.txt

Use cases:

Following example use cases are provided:

1. 118 bus T + 123 bus D + DER

Package details

Technical information on the package can be found here:

1. T&D Co-simulation
2. Software components

Issues

Please feel free to raise an issue for bugs or feature requests.

Who is responsible?

Project PI:

• Ning Kang [email protected]

Core developers:

• Karthikeyan Balasubramaniam [email protected]
• Sang-il Yim [email protected]

Support:

• Siby Jose Plathottam [email protected]
• Rojan Bhattarai [email protected]

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

Copyright © 2019, UChicago Argonne, LLC

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