Expand description
The canonical multiconductor network model.
Wire coordinates with BMOPF semantics: string bus ids, ordered string terminal names per bus, explicit grounding on buses, terminal maps on every element, SI units (V, W, var, ohm, S, meters) and radians. Terminal names are the OpenDSS node numbers as strings; implicit ground connections become an explicit perfectly grounded neutral terminal on the bus (named 4 on a three phase bus), the convention PowerModelsDistribution and the public BMOPF examples share.
Transformer impedances stay in the per unit form the source formats use
(r_pct, xsc_pct as percent of the winding base); the BMOPF writer
converts to ohms on the wye side at emission. Everything an element
carries beyond the typed fields lives in its extras map.
Structs§
- DistBus
- Dist
Capacitor - A rated capacitor bank (BMOPF schema 0.1.0
capacitor):q_ratedvars delivered atv_nomvolts across the element terminals, distinct from the raw admittanceDistShunt. The DSS converter still lowers OpenDSS capacitors to shunt B matrices; this element carries capacitors that arrive as BMOPF input. - Dist
Control Profile - Dist
Generator - DistIbr
- Dist
Line - Dist
Line Code - Dist
Load - Dist
Shunt - Dist
Switch - Dist
Transformer - Dist
Winding - Multiconductor
Network - A multiconductor distribution network: an immutable cheap to clone owning handle over private shared tables.
- Power
Factor Control - Untyped
Object - An object the reader recognized but does not type: preserved by class, name, and raw property text so conversions can warn precisely.
- Volt
VarControl - Volt
Watt Control - Voltage
Source
Enums§
- Active
Power Reference - Active
Power Unit - Configuration
- Control
Voltage Reference - Dist
Load Voltage Model - Dist
Source Format - Where the network came from; fixes the echo tier target.
- Dist
Winding Conn - IbrPrime
Mover - IbrTopology
- IbrVoltage
Aggregation - Reactive
Power Reference - Reactive
Power Unit
Functions§
- find_
unresolved_ references - Push a warning for every dangling or empty cross-reference. Bus and
linecode references are bare strings, a reader leaves an empty string
where the field is missing, and the graph projection synthesizes a
phantom bus for any unresolved id (the empty string included) — so a
typo or an absent field would otherwise parse cleanly into a
topologically wrong network. Comparison is ASCII case insensitive,
matching
MulticonductorNetwork::busandMulticonductorNetwork::linecode. The unresolved bus and linecode references of a network, as one message per finding: the same walk the reader’s warning pass runs, exposed so a decoder can refuse a document whose network fails it.
Type Aliases§
- Conductor
Matrix - A square matrix in conductor order, row major.
- Extras