Skip to content

Home

Jump to bottom
Peter Rochford edited this page Aug 22, 2023 · 5 revisions

Summary

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.

Installation

To install the package simply use the pip command:

pip install OpenDSS_SciVis

If you are upgrading the package then include the upgrade option:

pip install OpenDSS_SciVis --upgrade

Note that OpenDSS_SciVis only supports Python 3. Using pip to install may therefore not work.

Figure Examples

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.

Tutorial

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 Plots

Plotting Options

A list of the currently available plotting options can be found by following the links below:

Trouble Shooting

For problems encountered using the package refer to the FAQ page of the Wiki.

How to cite OpenDSS_SciVis

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}
}

References

Clone this wiki locally