cimhub-distopf 2.0.0a0

CIMHub DistOPF Library

cimhub_distopf

Converter between DistOPF (Distributed Optimal Power Flow) and CIM (IEC 61968/61970).

DistOPF is a distribution-level OPF solver that uses a linearized power flow formulation. This package imports DistOPF case data into CIM and exports CIM models to the DistOPF format.

Usage

DistOPF to CIM (Import)

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

from cimhub_distopf.importer.distopf_to_cim import distopf_to_cim

network = distopf_to_cim("/path/to/case/")

CIM to DistOPF (Export)

from cimhub_distopf.exporter.cim_to_distopf import cim_to_distopf

cim_to_distopf(network, "/path/to/output/")

Architecture

LinkML YAML  →  distopf_schema.py  →  GraphModel  →  DistopfReader / DistopfWriter
                                            ↕
                                  DistopfImporter / DistopfExporter

Running Tests

uv run pytest cimhub_distopf/tests/ -v