Skip to main content

Module model

Module model 

Source
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
DistCapacitor
A rated capacitor bank (BMOPF schema 0.1.0 capacitor): q_rated vars delivered at v_nom volts across the element terminals, distinct from the raw admittance DistShunt. The DSS converter still lowers OpenDSS capacitors to shunt B matrices; this element carries capacitors that arrive as BMOPF input.
DistControlProfile
DistGenerator
DistIbr
DistLine
DistLineCode
DistLoad
DistShunt
DistSwitch
DistTransformer
DistWinding
MulticonductorNetwork
A multiconductor distribution network: an immutable cheap to clone owning handle over private shared tables.
PowerFactorControl
UntypedObject
An object the reader recognized but does not type: preserved by class, name, and raw property text so conversions can warn precisely.
VoltVarControl
VoltWattControl
VoltageSource

Enums§

ActivePowerReference
ActivePowerUnit
Configuration
ControlVoltageReference
DistLoadVoltageModel
DistSourceFormat
Where the network came from; fixes the echo tier target.
DistWindingConn
IbrPrimeMover
IbrTopology
IbrVoltageAggregation
ReactivePowerReference
ReactivePowerUnit

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::bus and MulticonductorNetwork::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§

ConductorMatrix
A square matrix in conductor order, row major.
Extras