Install DiTTo

pip install ditto.py

This will install the basic version of ditto with limited dependencies. Because ditto supports conversion between many multiple formats, dependencies can be specified during installation For example:

pip install "ditto.py[extras,opendss,gridlabd]"

will install the required dependencies to convert between opendss and gridlab-d

To install the full dependency list run:

pip install "ditto.py[all]"

which is the same as

pip install "ditto.py[extras,opendss,cyme,dew,ephasor,synergi,gridlabd]" # same as `pip install "ditto.py[all]"`

Basic Usage

The most basic capability of DiTTo is the conversion of a distribution system from one format to another. To convert a cyme model represented in ASCII format with network.txt, equipment.txt and load.txt files, the following python script can be run to perform the conversion

from ditto.store import Store
from ditto.readers.cyme.read import Reader
from ditto.writers.opendss.write import Writer

store = Store()
reader = Reader(data_folder_path = '.', network_file='network.txt',equipment_file = 'equipment.txt', load_file = 'load.txt')
reader.parse(store)
writer = Writer(output_path='.')
writer.write(store)

The required input files for each reader format are defined in the folder of each reader

Command Line Interface

Ditto can also be run as a command line tool to perform basic conversion. The CLI accepts only one input file whatever the format. If we have a gridlabd model entirely stored in a file called model.glm we can use:

$ ditto-cli convert --from glm --input ./model.glm --to cyme

For formats like CYME where multiple input files are needed, a simple JSON configuration file is supplied:

{
    "data_folder_path": ".",
    "network_filename": "network.txt",
    "equipment_filename": "equipment.txt",
    "load_filename": "load.txt"
}

A default configuration file is found each reader folder. So to convert the cyme files described in the python program above, the following command would be used:

$ ditto-cli convert --from cyme --input ./config.json --to dss

Documentation on converting other formats can be found here.