Skip to main content

PowerIO

Rust Python Julia binding crates.io docs.rs PyPI MSRV 1.89 License: MIT OR Apache-2.0

PowerIO format and matrix flow

PowerIO reads power system data into typed values, writes those values back out in the formats other tools read, and builds the sparse matrices and graph data that solvers consume. The core is Rust, and the Python package, the Julia package PowerIO.jl, and the C ABI expose the same operations under the same names.

A parse returns a PioModule, which is one typed value together with its sources, diagnostics, source map, and history. Depending on what the source declares, the value is a network, an operating point, a calculation instance, a solution, a time series, a scenario set, a geographic layer, or a PSS/E contingency analysis file.

Convert files in the browser, including mixed transmission and distribution batches. Files stay on the computer.

Install

cargo add powerio                 # parsing, emission, PowerIO IR
cargo add powerio -F matrix       # and sparse matrices, sensitivities, graph data
pip install powerio               # pip install 'powerio[all]' adds SciPy, NetworkX, Polars
julia -e 'using Pkg; Pkg.add("PowerIO")'
cargo install powerio-cli         # the powerio command

Parse and emit

The examples use case9.m, the nine-bus MATPOWER case included in this repository. Save it in your working directory first, or replace "case9.m" with the path to your own case.

Rust:

use powerio::{PioValue, emit, parse};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let module = parse("case9.m")?;
    let PioValue::BalancedNetwork(network) = module.value() else {
        panic!("expected a balanced network");
    };
    assert_eq!(network.buses().len(), 9);
    emit(&module, "matpower", "copy.m")?;   // the source bytes, unchanged
    let result = emit(&module, "psse", "case9.raw")?;
    for finding in result.diagnostics() {
        eprintln!("{}", finding.code());    // what PSS/E cannot carry
    }
    Ok(())
}

Python:

import powerio

module = powerio.parse("case9.m")
network = module.value
assert isinstance(network, powerio.BalancedNetwork)
module.diagnostics                          # the reader's findings
powerio.emit(module, "matpower", "copy.m")  # the source bytes, unchanged
result = powerio.emit(module, "psse")       # text in memory plus findings

Julia:

using PowerIO

module_ = parse("case9.m")            # PioModule{BalancedNetwork}
net = module_.value
length(net.buses)                     # 9
module_.diagnostics
emit(module_, "matpower", "copy.m")

Command line:

powerio convert case9.m --to psse -o case9.raw
powerio serialize case9.m -o case9.pio.json
powerio verify case9.m --kind bdoubleprime
powerio sensitivities case9.m -o out

If you write an unchanged module back to its own format, you get the source back byte for byte. If you write it to another format, PowerIO keeps what that format can represent and reports each loss as a diagnostic with a stable code, so you can see what the conversion dropped. serialize and deserialize write and read PowerIO IR, the JSON document that stores a complete module for another PowerIO consumer to read back. It preserves the typed data and its history; retained source bytes stay in the running process. After deserialization, emit writes fresh output from the stored value.

Formats

Format Token Read Write
MATPOWER .m matpower yes yes
PSS/E RAW psse, psse34, psse35 revisions 32 to 35 33, 34, 35
PSS/E RAWX psse-rawx revision 35 35
PSS/E contingency, subsystem, and monitored element files .con, .sub, .mon psse-con, psse-sub, psse-mon yes yes
PowSybl XIIDM xiidm 1.0 to 1.17 1.17
PowSybl JIIDM jiidm 1.0 to 1.17 1.17
CIM CGMES profile set cgmes 2.4.15, 3.0 3.0
ENTSO-E UCTE-DEF .uct ucte 2003.09.01, 2007.05.01 2007.05.01
PowerWorld .aux powerworld yes yes
PowerWorld .pwb pwb yes no
PowerWorld .pwd display powerworld-pwd yes no
GE PSLF .epc pslf yes yes
IEEE Common Data Format ieee-cdf yes no
PowerModels JSON powermodels-json yes yes
Egret JSON egret-json yes yes
pandapower JSON, balanced and three-phase profiles pandapower-json yes yes; a three-phase network only as its unchanged source
PyPSA CSV directory pypsa-csv yes yes
SiennaSchemas SystemDocument sienna-json, sienna-0-{1,2,3,4}-json 0.1.0 through 0.4.0 0.1.0 through 0.4.0
PowerSystems.jl serialized System powersystems-json data formats 4, 5 data format 5
Surge JSON surge-json yes yes
MG-RAVENS JSON, balanced and multiconductor profiles ravens-json yes yes
GridFM Parquet directory, gridfm feature gridfm yes yes
DOE GO Challenge 3 JSON goc3-json problem, or problem with solution a complete solution
DeepMind OPFData JSON opfdata-json yes no
OpenDSS .dss dss yes yes
PowerModelsDistribution ENGINEERING JSON pmd-json yes yes
PowerModelsDistribution MATHEMATICAL JSON pmd-math-json yes yes
BMOPF JSON bmopf-json yes; older drafts, PowerIO 0.11 output among them, read as BMOPF the Task Force's proposed schema
Distribution CIM, CIM100 RDF/XML cim-dist cim17v40, one document or a directory cim17v40, one document
PSS SINCAL project, sincal feature sincal-balanced, sincal-multiconductor yes, with an explicit profile an unchanged source byte for byte; an experimental fresh writer in Rust
Geographic layer .geo.json geo-json yes yes

Python also provides optional Sienna JSON/HDF5 bundles and PyPSA NetCDF/HDF5 transports. See Sienna exchange and pipeline integration.

The balanced transmission formats parse to BalancedNetwork, and OpenDSS, PMD, BMOPF, and distribution CIM parse to MulticonductorNetwork. A three-phase pandapower document (rows in asymmetric_load, asymmetric_sgen or res_bus_3ph) parses to MulticonductorNetwork too, unless it has rows in a table only the balanced reader maps yet (trafo, shunt, gen, storage, dcline) and that reader accepts it; see pandapower three-phase JSON. SINCAL holds both kinds of network in one project, so a parse names its profile: sincal-balanced gives a BalancedNetwork and sincal-multiconductor a MulticonductorNetwork. A GO Challenge 3 problem parses to AcScucInstance, a problem with its solution to AcScucSolution, an OPFData file to AcOpfSolution, a GridFM dataset to ScenarioSet<BalancedNetwork>, a PyPSA directory with several snapshots to a TimeSeries<BalancedNetwork>, or to TimeSeries<OperatingPoint<BalancedNetwork>> when only the electrical state varies, a PowerWorld .pwd display and a .geo.json file to GeoLayer, and the PSS/E .con, .sub, and .mon files to ContingencySet, SubsystemSet, and MonitoredSet. PowerIO IR is not in the table: it moves only through serialize and deserialize, and parse refuses it.

The gridfm and sincal cargo features gate their formats. The facade leaves gridfm off and turns sincal on by default; the CLI and the Python wheel include both. The format guide says what each reader keeps, what each writer reports, and how each is checked against its reference implementation.

Packages

Start with powerio in an application. The component crates let libraries depend on just the layer they use.

Crate Provides
powerio PioValue, parse, emit, serialize, deserialize
powerio-core Source, PioModule, diagnostics, collections, destinations
powerio-archive Bounded ZIP indexing and verified member reads
powerio-tx BalancedNetwork and balanced format readers and writers
powerio-dist MulticonductorNetwork and OpenDSS, PMD, BMOPF, CIM converters
powerio-tnd Integrated transmission/distribution models, cross-model transforms, SINCAL and MG-RAVENS dispatch
powerio-prob Operating points, updates, calculation instances and solutions
powerio-matrix Sparse matrices, sensitivities, DC OPF bundles and graph data
powerio-synth Synthetic network generators for tests and benchmarks
powerio-cli The powerio command and its terminal interface
powerio-py The native extension used by the Python package
powerio-capi The C ABI, used by Julia and other FFI bindings

powerio-tx and powerio-dist share powerio-core and nothing else, so a distribution consumer pulls in no transmission code. powerio-prob is matrix free. The powerio facade re-exports the component crates, with powerio-matrix behind its matrix feature. Native SINCAL support is the sincal feature, on by default; it brings in SQLite, so a wasm32-unknown-unknown build with it needs a C compiler with a WebAssembly backend, and default-features = false leaves it out.

Documentation

License

Apache License 2.0 or MIT License, at your option.

Metadata

Release files for powerio 0.12.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for powerio 0.12.2
File Size Uploaded Provenance Actions
powerio-0.12.2.tar.gz 3.6 MB With provenance Details for powerio-0.12.2.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for powerio 0.12.2
File Actions
powerio-0.12.2-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for powerio-0.12.2-cp311-abi3-win_amd64.whl
powerio-0.12.2-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.11 abi3 Linux glibc 2.17+ x86-64 Details for powerio-0.12.2-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
powerio-0.12.2-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.11 abi3 Linux glibc 2.17+ ARM64 Details for powerio-0.12.2-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
powerio-0.12.2-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details for powerio-0.12.2-cp311-abi3-macosx_11_0_arm64.whl
powerio-0.12.2-cp311-abi3-macosx_10_12_x86_64.whl CPython 3.11 abi3 macOS 10.12+ x86-64 Details for powerio-0.12.2-cp311-abi3-macosx_10_12_x86_64.whl

Total release size: 79.1 MB

Release files / powerio-0.12.2.tar.gz

Download URL powerio-0.12.2.tar.gz
Size 3.6 MB
Tags Source
SHA-256 checksum
How to use checksums
bb30ff1076e7937d3277ea23f0fd0cc4c2db9d65b4325fad6f1964aa99333240
BLAKE2b-256 checksum
How to use checksums
17b3052e8253dc809bf706203481fa03e2110edf6ff65c060ea335b400b7b029
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / powerio-0.12.2-cp311-abi3-win_amd64.whl

Download URL powerio-0.12.2-cp311-abi3-win_amd64.whl
Size 16.6 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
44ce6952cc6d193c072c0e240295e4fd7bade640fe0af7eb05c713b45cfb71a6
BLAKE2b-256 checksum
How to use checksums
b2425b91ea655dd044f43ec293f976b6c208180890957b487e952c6d1699eb0f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / powerio-0.12.2-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL powerio-0.12.2-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 15.7 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
c19ed2c321b71aae47d3e9d5ce65a70e3a96bb4dcc30099e2f33bafdcd71c97e
BLAKE2b-256 checksum
How to use checksums
89d94bf83f7386a5b4a16f1e6b3b974251a2e9c8ae4fcba8e85159b87343ae7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / powerio-0.12.2-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL powerio-0.12.2-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 14.2 MB
Tags CPython 3.11 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
e5197c87d7babb48f95333bf069f51ba99fc1869b0c9275eb6e49cad0b8b018b
BLAKE2b-256 checksum
How to use checksums
daf019dc68d60eaffc13d2865cfbbaa814cabb7f4101462a5107462b1a1f178d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / powerio-0.12.2-cp311-abi3-macosx_11_0_arm64.whl

Download URL powerio-0.12.2-cp311-abi3-macosx_11_0_arm64.whl
Size 13.8 MB
Tags CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
5f971e63eeeedf33ff37e65aee266c12e8911551782d2556a60467c977c9c941
BLAKE2b-256 checksum
How to use checksums
ada27b0ddf35bcadcc6c681f6fc6cee2dae2ccaec12bf364c7e2224a71775832
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / powerio-0.12.2-cp311-abi3-macosx_10_12_x86_64.whl

Download URL powerio-0.12.2-cp311-abi3-macosx_10_12_x86_64.whl
Size 15.2 MB
Tags CPython 3.11 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
7f6f178436b961b2a39a341b3fe32e31fd972b00243a040d9951694f921b3a8e
BLAKE2b-256 checksum
How to use checksums
2ea8c3cd82a0d5b45ad3a06f67aba74cc5870c4b8adcebcdb3c7c4871253c994
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for powerio 0.12.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for powerio-0.12.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.12.2 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page