-
Notifications
You must be signed in to change notification settings - Fork 0
Home
This Python package contains a collection functions for conveniently accessing and plotting data in the Comma-Separated Value (CSV) files produced by the OpenDSS software application. OpenDSS is an electric power Distribution System Simulator (DSS) designed to support distributed energy resource (DER) grid integration and grid modernization. It enables engineers to perform complex analyses using a flexible, customization, and easy to use platform intended specifically to meet current and future distribution system challenges and provides a foundation for understanding and integrating new technologies and resources.
To install the package simply use the pip3 command:
pip3 install OpenDSS_SciVis
If you are upgrading the package then include the upgrade option:
pip3 install OpenDSS_SciVis --upgrade
Note that OpenDSS_SciVis only supports Python 3. Using pip to install may therefore not work.
The plots produced by the several examples posted on this wiki can be viewed by following the links shown below. This is a useful starting point for users looking to identify the best example from which to begin plotting the OpenDSS data for their specific need by modifying the accompanying Python script.
An easy tutorial is provided here in the form of a series of example scripts to illustrate how to produce plots in a variety of formats using the OpenDSS SciVis package. These series of examples provide an easy tutorial on how to use the various options of the plotting functions. They also provide a quick reference in future for how to produce plots with specific features. The plots produced by each script are in Portable Network Graphics (PNG) format and have the same file name as the script with a "png" suffix. Examples of the plots produced can be found in the Examples folder with the same file name as the script and ending in '_example.png'. For example the diagram produced by Example01.m is named Example01.png. Follow the links below to navigate to each of the examples.
Examples will be added over time as the OpenDSS_SciVis package continues to evolve.
- Time Series Options
- Example 1 (Example01.py, Example01.png, data file: Example01.zip)
A list of the currently available plotting options can be found by following the links below:
For problems encountered using the package refer to the FAQ page of the Wiki.
Kevin Wu and Peter A. Rochford (2023) OpenDSS_SciVis: A Python package for scientific visualization of OpenDSS model results, https://github.com/kevinwuw/OpenDSS_SciVis
@misc{wuopendss_scivis,
title={OpenDSS_SciVis: A Python package for scientific visualization of OpenDSS model results},
author={Kevin Wu, Peter A. Rochford},
year={2023},
url={https://github.com/PeterRochford/OpenDSS_SciVis}
}
- Dugan, R. C., & Montenegro, D. (2020). The Open Distribution System Simulator (OpenDSS) Reference Guide. Electric Power Research Institute. Washington, DC: Electric Power Research Institute. Retrieved from https://sourceforge.net/p/electricdss/code/HEAD/tree/trunk/Distrib/Doc/OpenDSSManual.pdf
- Electric Power Research Institute. (2022, April 2). OpenDSS. Retrieved from EPRI: https://www.epri.com/pages/sa/opendss
- Fu, F. (2019). OpenDSS Tutorial and Cases. Iowa State University, Department of Electrical and Computer Engineering. Ames, Iowa: Iowa State University. Retrieved from https://www.coursehero.com/file/87693420/EE653-OpenDSS-Tutorial-and-Casespptx