ditto.py 0.2.1

Distribution Feeder Conversion Tool

DiTTo is a Distribution Transformation Tool that aims at providing an open source framework to convert various distribution systems modeling formats. DiTTo implements a many-to-one-to-many parsing framework which makes it modular and robust. Readers and writers are then implemented to perform the translation from a given format to the core representation, or the other way around.

Quick Start

Install DiTTo

pip install git+https://github.com/NREL/ditto.git@v0.1.0#egg=ditto[all]

Basic Usage

Test4Node

source=http://sites.ieee.org/pes-testfeeders/resources/

The most basic capability of DiTTo is the conversion of a distribution system from one format to another. Let’s say we have the IEEE 4 node feeder in OpenDSS format as a file called master.dss:

clear

new circuit.4BusYYbal basekV=12.47 phases=3

!Wires definition
new wiredata.conductor Runits=mi Rac=0.306 GMRunits=ft GMRac=0.0244  Radunits=in Diam=0.721
new wiredata.neutral   Runits=mi Rac=0.592 GMRunits=ft GMRac=0.00814 Radunits=in Diam=0.563

!LineGeometry definition
new linegeometry.4wire nconds=4 nphases=3 reduce=yes cond=1 wire=conductor units=ft x=-4 h=28 cond=2 wire=conductor units=ft x=-1.5 h=28 cond=3 wire=conductor units=ft x=3 h=28 cond=4 wire=neutral units=ft x=0    h=24

!Lines definition
new line.line1 geometry=4wire length=2000 units=ft bus1=sourcebus bus2=n2
new line.line2 bus1=n3 bus2=n4 geometry=4wire length=2500 units=ft

!Transformer definition
new transformer.t1 xhl=6 wdg=1 bus=n2 conn=wye kV=12.47 kVA=6000 %r=0.5 wdg=2 bus=n3 conn=wye kV=4.16  kVA=6000 %r=0.5

!Load definiion
new load.load1 phases=3 bus1=n4 conn=wye kV=4.16 kW=5400 pf=0.9  model=1 vminpu=0.75

!Set voltage base and solve circuit
set voltagebases=[12.47, 4.16]
calcvoltagebases
solve

To convert this system to another format, say CYME for example, the easiest way is to use the command line interface. From the directory where master.dss is located, run:

$ ditto-cli convert --from opendss --to cyme --input ./master.dss --output .

This command basically reads the OpenDSS input (./master.dss) into the DiTTo core representation and output the system to CYME (since the output is “.”, the files will be written in the same folder).

After running this command you should see the output in the current directory:

$ ls | grep .txt
./equipment.txt
./loads.txt
./network.txt

Going further

More documentation can be found here.

Documentation on converting other formats can be found here.

Contributing

DiTTo is an open source project and contributions are welcome! Either for a simple typo, a bugfix, or a new parser you want to integrate, feel free to contribute.

To contribute to Ditto in 3 steps: - Fork the repository (button in the upper right corner of the DiTTo GitHub page). - Create a feature branch on your local fork and implement your modifications there. - Once your work is ready to be shared, submit a Pull Request on the DiTTo GitHub page. See the official GitHub documentation on how to do that here

Getting Help

If you are having issues using DiTTo, feel free to open an Issue on GitHub here

All contributions are welcome. For questions about collaboration please email Tarek Elgindy