cimhub_matpower

Bidirectional converter between MATPOWER (.m case files) and CIM (IEC 61970) using the cim17v40 profile.

Usage

MATPOWER to CIM (Import)

import os
os.environ['CIMG_CIM_PROFILE'] = 'cim17v40'

from cimhub_matpower.importer.matpower_to_cim import matpower_to_cim

network = matpower_to_cim("case9.m")

CIM to MATPOWER (Export)

from cimhub_matpower.exporter.cim_to_matpower import cim_to_matpower

cim_to_matpower(network, "output.m")

Equipment Coverage

Unit Conventions

MATPOWER uses per-unit impedances on the system MVA base. The converter handles the z_base = base_kv² / base_mva conversion automatically — do not manually multiply by baseMVA.

Generator sign convention: MATPOWER Pg is positive for generation (power out). CIM Terminal.p is positive for power flowing into equipment — the converter negates when crossing the boundary.

Running Tests

uv run pytest cimhub_matpower/tests/ -v

Status

• Importer: functional for buses, generators, branches, gencost, areas.
• Exporter: implemented; full roundtrip tests in progress.
• Known gap: reactive power limits (Qmin/Qmax) and transformer tap ratios need validation.