Expand description
Multiconductor distribution network models and converters for OpenDSS
.dss, PowerModelsDistribution ENGINEERING
JSON (“PMD JSON”), the draft JSON schema of the IEEE PES Task Force on
Benchmarking Multiconductor OPF (“BMOPF JSON”,
https://github.com/distribution-system-opt/dsopt-schema), and
distribution CIM (CIM100 RDF/XML, see cim).
The model uses wire coordinates: string bus IDs, ordered terminal names,
explicit grounding, terminal maps on every element, SI units, and radians.
The transmission model in powerio is positive sequence and remains a
separate type.
let source = powerio_core::Source::open("feeder.dss")?;
let module = powerio_dist::parse(source)?;
for line in powerio_dist::diagnostics::render_diagnostics(module.diagnostics()) {
eprintln!("parse: {line}");
}
let emitted = powerio_dist::emit(
&module,
powerio_dist::DistTargetFormat::PmdJson,
powerio_core::Destination::memory("feeder.pmd.json")?,
)?;
for line in powerio_dist::diagnostics::render_diagnostics(emitted.diagnostics()) {
eprintln!("emit: {line}");
}SINCAL adapters are provided by powerio_tnd::formats::sincal and the
powerio facade. This model crate is independent of SQLite and integration.
§Fidelity rules
Emitting to the retained source format returns the original bytes. Cross
format emission uses the typed model and reports fields the target cannot
represent through powerio_core::EmitResult::diagnostics. The DSS reader expands OpenDSS
class defaults into explicit model values and records them in
MulticonductorNetwork::defaulted. BMOPF output includes those values.
The per fixture results live in docs/conversion-matrix.md.
§Float formatting
Canonical output formats every number as its shortest round trip
representation: Rust’s Display for .dss, serde_json (ryu) for both
JSON formats. The readers parse with serde_json’s float_roundtrip
feature, so a parse of canonical output recovers the exact bit pattern
and canonical emissions are idempotent. JSON cannot carry Inf/NaN: the
PMD emitter uses null (PMD restores the value from the field name
suffix), and the BMOPF emitter uses 0 with a warning, since the schema
requires numbers. The byte exact echo tier is unaffected; it never
reformats.
Re-exports§
pub use bmopf::BMOPF_SCHEMA_ID;pub use bmopf::BMOPF_SCHEMA_VERSION;pub use bmopf::BmopfEmitOptions;pub use bmopf::BmopfSchemaVersion;pub use cim::CIM_DIST_HEAD_BYTES;pub use cim::looks_like_cim_dist;pub use cim::looks_like_cim_dist_header;pub use cim::source_looks_like_cim_dist;pub use convert::DistTargetFormat;pub use convert::EmitOptions;pub use convert::classify_distribution_json;pub use convert::emit;pub use convert::emit_with_options;pub use convert::parse;pub use convert::parse_dist_target_format;pub use dss::DssEmitOptions;pub use dss::DssLoadVoltageBounds;pub use error::Error;pub use error::Result;pub use geo::CoordinateSpace;pub use geo::DistCanvas;pub use geo::DistComponentLocation;pub use geo::DistCoordsKind;pub use geo::DistGeoMeta;pub use geo::DistGeographicPoint;pub use geo::DistLocation;pub use geo::DistLocationTarget;pub use graph::DistGraph;pub use graph::DistGraphAttachment;pub use graph::DistGraphAttachmentKind;pub use graph::DistGraphBus;pub use graph::DistGraphEdge;pub use graph::DistGraphEdgeKind;pub use kron::NeutralKronAction;pub use kron::NeutralKronBus;pub use kron::NeutralKronGrounding;pub use kron::NeutralKronOptions;pub use kron::NeutralKronRecovery;pub use kron::NeutralKronReduction;pub use kron::NeutralKronReport;pub use kron::neutral_kron_reduce;pub use lindist3flow::LinDist3FlowPreparationAction;pub use lindist3flow::LinDist3FlowPreparationActionKind;pub use lindist3flow::LinDist3FlowPreparationPolicy;pub use lindist3flow::LinDist3FlowPreparationReport;pub use lindist3flow::LinDist3FlowPreparedNetwork;pub use lindist3flow::prepare_lindist3flow_network;pub use model::ActivePowerReference;pub use model::ActivePowerUnit;pub use model::ConductorMatrix;pub use model::Configuration;pub use model::ControlVoltageReference;pub use model::DistBus;pub use model::DistCapacitor;pub use model::DistControlProfile;pub use model::DistGenerator;pub use model::DistIbr;pub use model::DistLine;pub use model::DistLineCode;pub use model::DistLoad;pub use model::DistLoadVoltageModel;pub use model::DistShunt;pub use model::DistSourceFormat;pub use model::DistSwitch;pub use model::DistTransformer;pub use model::DistWinding;pub use model::DistWindingConn;pub use model::Extras;pub use model::IbrPrimeMover;pub use model::IbrTopology;pub use model::IbrVoltageAggregation;pub use model::MulticonductorNetwork;pub use model::PowerFactorControl;pub use model::ReactivePowerReference;pub use model::ReactivePowerUnit;pub use model::UntypedObject;pub use model::VoltVarControl;pub use model::VoltWattControl;pub use model::VoltageSource;pub use model::find_unresolved_references;pub use readiness::ElectricalReadiness;pub use readiness::ReadinessFinding;pub use readiness::ReadinessSeverity;pub use readiness::audit_electrical_readiness;pub use readiness::require_electrical_readiness;
Modules§
- bmopf
- The BMOPF task force JSON schema (https://github.com/distribution-system-opt/dsopt-schema).
- cim
- Distribution CIM: IEC 61968 and 61970 CIM100 RDF/XML for unbalanced
feeders, read into and written from the
MulticonductorNetwork(format tokencim-dist). - convert
- Distribution format dispatch.
- diagnostics
- The codes this crate emits.
- dss
- OpenDSS
.dsssupport: tokenizer, RPN, class tables, raw object layer. - error
- geo
- Typed coordinate metadata for the distribution model.
- glm
- GridLAB-D source syntax, bounded offline preprocessing and static import.
- graph
- Render ready bus and terminal graph projection.
- kron
- Explicit-neutral Kron projection for
MulticonductorNetwork. - lindist3flow
- Audited, format-neutral network preparation for LinDist3Flow.
- model
- The canonical multiconductor network model.
- pmd
- The PowerModelsDistribution ENGINEERING model as JSON (“PMD JSON”).
- readiness
- Pre-solver structural readiness checks for distribution networks.
Structs§
- Diagnostic
- One coded user facing finding.
- Diagnostic
Code - Stable dotted identity of one diagnostic.
Enums§
- Diagnostic
Severity - Severity of one user facing finding.
- Diagnostic
Stage - Pipeline stage encoded by the first segment of a diagnostic code.