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.3

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.3
File Size Uploaded Provenance Actions
powerio-0.12.3.tar.gz 3.7 MB With provenance Details for powerio-0.12.3.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for powerio 0.12.3
File Actions
powerio-0.12.3-cp311-abi3-win_amd64.whl CPython 3.11 abi3 Windows x86-64 Details for powerio-0.12.3-cp311-abi3-win_amd64.whl
powerio-0.12.3-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.3-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
powerio-0.12.3-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl CPython 3.11 abi3 Linux glibc 2.17+ ARM64 Details for powerio-0.12.3-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
powerio-0.12.3-cp311-abi3-macosx_11_0_arm64.whl CPython 3.11 abi3 macOS 11.0+ ARM64 Details for powerio-0.12.3-cp311-abi3-macosx_11_0_arm64.whl
powerio-0.12.3-cp311-abi3-macosx_10_12_x86_64.whl CPython 3.11 abi3 macOS 10.12+ x86-64 Details for powerio-0.12.3-cp311-abi3-macosx_10_12_x86_64.whl

Total release size: 79.3 MB

Release files / powerio-0.12.3.tar.gz

Download URL powerio-0.12.3.tar.gz
Size 3.7 MB
Tags Source
SHA-256 checksum
How to use checksums
7e396ef4b82e506d72167bfe0f71d455e30a227c2cfffe2966512f7543c0c641
BLAKE2b-256 checksum
How to use checksums
1a562367e4b74eb8bcbb10e6ba2229e1449c88f68531aa3df7af7f339ea64f61
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 18, 2026.

Transparency log

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

Download URL powerio-0.12.3-cp311-abi3-win_amd64.whl
Size 16.6 MB
Tags CPython 3.11 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
f3d0634e28894c3d1168285af884d8eb0eb6b4227f4a42666f1a71fb7a211e1a
BLAKE2b-256 checksum
How to use checksums
572f856b4f4590c5e9f8895b39e96c7bd5e0a6907e7434a9ba7b16cdfcdb99ea
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 18, 2026.

Transparency log

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

Download URL powerio-0.12.3-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 15.8 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
510fcf54db78fabdd4ce51e5a556f1d6792ad3c4a43c6d0dc4bdde8535b6bc77
BLAKE2b-256 checksum
How to use checksums
3deaa83d776b4888819e9c645bd30a3bae083d27e6fc59defe1a21692d279437
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 18, 2026.

Transparency log

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

Download URL powerio-0.12.3-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
e146ebc1522b2072b0faface2e3e1704f2fad2ac26d4812451363a0be142610b
BLAKE2b-256 checksum
How to use checksums
47c0f47b286660e0d3cb3a5bf7f4421c8b6546a038848977be9e03231eec86c8
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 18, 2026.

Transparency log

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

Download URL powerio-0.12.3-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
17194caf7b2dc39b5a30a7992eb8aa506d8c707257d98efb9f18531a7af94865
BLAKE2b-256 checksum
How to use checksums
d3423053bf3b55b15e572ec6c4313a74c7c081c40c6a1e12d8b110f81fcf3ce9
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 18, 2026.

Transparency log

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

Download URL powerio-0.12.3-cp311-abi3-macosx_10_12_x86_64.whl
Size 15.3 MB
Tags CPython 3.11 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
a7cb530d10ae3da82b2da94d349f031efabed0d1ca051077346db5e48ef41792
BLAKE2b-256 checksum
How to use checksums
f8e61e6220e32d0ea08a94abaf0b89de5e2051476482cdda64d27a34a8eded8e
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 18, 2026.

Transparency log

Security for powerio 0.12.3

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.3.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 18, 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.3 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