cimhub-opendss 2.0.0a0

CIMHub OpenDSS Library

Cimhub OpenDSS

Bidirectional converter between OpenDSS and CIM (IEC 61968/61970) using the cimhub_2026 profile.

Usage

DSS to CIM (Import)

import os
os.environ['CIMG_USE_UNITS'] = 'TRUE'
os.environ['CIMG_CIM_PROFILE'] = 'cimhub_2026'

from cimhub_opendss.importer.dss_to_cim import dss_to_cim

feeder = dss_to_cim("/path/to/Master.dss")

CIM to DSS (Export)

from cimhub_opendss.exporter.cim_to_dss import cim_to_dss

cim_to_dss(feeder, "/path/to/output_dir")
# Writes Master.dss + per-component .dss files

Roundtrip Validation

A full DSS -> CIM -> DSS roundtrip integration test is provided for the IEEE 13-bus feeder:

uv run python cimhub_opendss/tests/test_ieee13_roundtrip.py
# or via pytest:
uv run pytest cimhub_opendss/tests/test_ieee13_roundtrip.py -vs

The roundtrip parses the IEEE 13-bus DSS model, imports to CIM, exports back to DSS, solves both models with OpenDSS, and compares total power and bus voltages. Current accuracy is within 0.14% on active power (4.4 kW on a 3230 kW system).

Models

Mandatory

• Power Transformer
• Transformers
• Regulator Controls
• Line Code
• Line
• Capacitor
• Load
• PV System
• Storage
• Switch
• Fuse
• Recloser
• Breaker
• Generator
• CNData (importer only)
• TSData (importer only)
• Line Geometry (importer only)
• Line Spacing (importer only)
• Wire Data
• XY Curve

As Needed

• GIC Transformer
• GIC Line
• Induction Machine
• UPFC Device
• Wind Generator
• Capacitor Control
• Inverter Control
• Storage Control
• Switch Control
• UPFC Control