Distribution Transformation Tool (DiTTo)#

DiTTo is an open-source many-to-one-to-many converter for electrical distribution system models. It reads models from various industry-standard formats, builds a validated intermediate representation using Grid-Data-Models (GDM), and writes them back to any supported output format.

Architecture#

        flowchart LR
    A["Source Format\n(OpenDSS, CIM, …)"] -->|Reader| B["GDM\nDistributionSystem"]
    B -->|Writer| C["Target Format\n(OpenDSS, …)"]
    B -->|Serialize| D["JSON on disk"]
    

Readers parse source files into GDM components.
Writers export a GDM DistributionSystem to a target format.
The intermediate GDM representation can also be serialised to JSON for inspection or re-use.

Supported Formats#

Format

Reader

Writer

OpenDSS

CIM IEC 61968-13

Quick Start#

pip install nrel-ditto
from ditto.readers.opendss.reader import Reader

reader = Reader("Master.dss")
system = reader.get_system()
reader.to_json("model.json")

See the Installation and Usage pages for full details.

Contributors#

  • Tarek Elgindy

  • Aadil Latif

  • Kapil Duwadi

  • Daniel Thompson

  • Jeremy Keen