This release is a pre-release and may not be stable for production use.
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cimhub_opendss-2.0.0a2.tar.gz.
File metadata
- Download URL: cimhub_opendss-2.0.0a2.tar.gz
- Upload date:
- Size: 335.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed9ea470076641c77affafa65a5c3c19e7484e94af6f909995c55f0cf2f7b0fe
|
|
| MD5 |
966791b67d6547ad210b7683ddbfd939
|
|
| BLAKE2b-256 |
461e8dc5f042cfddf51c1ddcb0514c92bdcd68ee7f35ef5072c2bfda7e47f81a
|
Provenance
The following attestation bundles were made for cimhub_opendss-2.0.0a2.tar.gz:
Publisher:
publish-cimhub-opendss.yml on PNNL-CIM-Tools/CIMHub
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cimhub_opendss-2.0.0a2.tar.gz -
Subject digest:
ed9ea470076641c77affafa65a5c3c19e7484e94af6f909995c55f0cf2f7b0fe - Sigstore transparency entry: 2498856197
- Sigstore integration time:
-
Permalink:
PNNL-CIM-Tools/CIMHub@a52b64556614928077b56ad790c3dfceddde552f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PNNL-CIM-Tools
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-cimhub-opendss.yml@a52b64556614928077b56ad790c3dfceddde552f -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file cimhub_opendss-2.0.0a2-py3-none-any.whl.
File metadata
- Download URL: cimhub_opendss-2.0.0a2-py3-none-any.whl
- Upload date:
- Size: 360.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2c0928507029e023303b245f13d9ad9038f8e6e451592c4d0f1b7065d3ebf872
|
|
| MD5 |
354d783f7d882d7b3776ad0b5d83d1ea
|
|
| BLAKE2b-256 |
907ea66b66601b42e016bef698ac5f04bf20f266f6cadf4d107108861cd6728e
|
Provenance
The following attestation bundles were made for cimhub_opendss-2.0.0a2-py3-none-any.whl:
Publisher:
publish-cimhub-opendss.yml on PNNL-CIM-Tools/CIMHub
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cimhub_opendss-2.0.0a2-py3-none-any.whl -
Subject digest:
2c0928507029e023303b245f13d9ad9038f8e6e451592c4d0f1b7065d3ebf872 - Sigstore transparency entry: 2498856204
- Sigstore integration time:
-
Permalink:
PNNL-CIM-Tools/CIMHub@a52b64556614928077b56ad790c3dfceddde552f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/PNNL-CIM-Tools
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish-cimhub-opendss.yml@a52b64556614928077b56ad790c3dfceddde552f -
Trigger Event:
workflow_dispatch
-
Statement type:
