Expand description
Native multiconductor nodal admittance over MulticonductorNetwork
(#232): terminal and conductor indexed, in the network’s actual units
(volts, amperes, siemens), with no implicit positive sequence
transformation anywhere.
The voltage unknown rows are the ungrounded bus terminals: terminal 0
and every explicitly grounded terminal are excluded, and buses joined by
an exact unity connection (a closed switch) merge into one electrical
node rather than receiving an arbitrary small impedance. Every axis
carries the stable DistNode mapping — bus identity plus terminal — so
mappings remain valid after source row reordering.
The passive admittance carries lines (series and both shunt halves from
the linecode), shunts, capacitor banks, and every transformer that states
leakage: its terminal primitive
(calc_transformer_primitive_admittance) carries WYE and DELTA
windings, fixed taps, the magnetizing branch and finite neutral
impedances, for two winding units, the BMOPF centre tap and the BMOPF
single phase autotransformer. A solidly grounded transformer neutral
enters the augmented system as an exact zero voltage row. Ideal equipment
— a two winding transformer stating no leakage and voltage sources —
enters the augmented system as exact constraint rows over the node
voltages with their coupled ideal currents. Ideal WYE windings retain
explicit floating or grounded neutral terminals; an ideal unit with a
non-WYE connection, neutral impedances, a core shunt or tap bounds, and a
leakage unit outside the primitive’s shapes, return an unsupported
physics error before assembly. Tap bounds on a leakage unit are decision
data the nodal system does not read: it stamps the stated fixed tap.
Structs§
- Augmented
System - One ideal constraint row of the augmented system: exact relations over the node voltages, with the row’s coupled ideal current entering the nodal balance through the transpose.
- Dist
Node - One voltage unknown: a bus terminal, by stable identity.
- Grounded
Neutral - A transformer neutral the source grounds solidly: an exact zero voltage
at
(bus, terminal), not an admittance. - Multiconductor
Admittance - The assembled multiconductor nodal system.
- Multiconductor
Node Index - The dense node indexing of one multiconductor network, over powerio-dist’s flat terminal index (so bus names compare ASCII case insensitively, as every multiconductor calculation reads them).
- Network
Primitives - Every admittance element of a network with the exact constraints it
leaves to the caller:
calc_passive_primitives. - Passive
Primitive - One passive element’s primitive admittance, siemens, with the bus terminal behind each primitive row.
- Transformer
Primitive - A finite leakage transformer’s primitive admittance, siemens, over its physical terminals.
Enums§
- NodeRef
- Where a bus terminal lands in the nodal system.
- Passive
Family - The passive element family behind a
PassivePrimitive. - Transformer
Leakage Base - The unit system a transformer states its leakage in, which
calc_transformer_leakage_impedancesreads.
Functions§
- assemble_
multiconductor_ admittance calc_multiconductor_admittance_matrixover element primitives the caller already holds fromcalc_passive_primitivesof the same network: a caller that also reads each element’s primitive (for its port currents) lists them once. The one assembly of the multiconductor nodal system and its source, ideal transformer and grounded neutral rows.- calc_
capacitor_ primitive_ admittance - A capacitor bank’s primitive admittance, siemens, over its terminal map:
jtimes its susceptance (powerio_dist::calc_capacitor_susceptance). - calc_
line_ primitive_ admittance - The primitive admittance of a line, siemens, over its terminals in the
order
terminal_map_fromthenterminal_map_to: the inverse of the linecode’s series impedance over the length couples the two ends, and each end carries its shunt half, - calc_
multiconductor_ admittance_ matrix - Build the passive nodal admittance and the ideal equipment constraints.
- calc_
passive_ primitives - Every admittance element of the network with its primitive admittance:
lines (series inverse and both shunt halves,
calc_line_primitive_admittance), then shunts (calc_shunt_primitive_admittance), then capacitor banks (calc_capacitor_primitive_admittance), then every transformer that states leakage (calc_transformer_primitive_admittance), each family in table order, with the transformers’ solidly grounded neutrals and the ideal transformers left for exact constraints. The one element list:calc_multiconductor_admittance_matrixscatters it over its node references, and a caller indexing terminals its own way scatters it over its positions withscatter_primitive_admittance. - calc_
shunt_ primitive_ admittance - The primitive admittance of a shunt element, siemens, over its
terminal_map: its statedG + j B. - calc_
transformer_ leakage_ impedances - The pairwise leakage impedances of a multiwinding transformer, referred
to the first winding: for windings
aandb, on a per winding baseB_aand a reference baseB_ref, - calc_
transformer_ primitive_ admittance - The primitive admittance of a finite leakage transformer, siemens, over
its physical terminals, following the OpenDSS
CalcY_Terminalpath: the winding domainY_1Volt(calc_transformer_winding_admittance, the inverse of the reduced pairwise leakage ofcalc_transformer_leakage_impedances) is referred to each phase’s coils through the turns and base factors, - calc_
transformer_ winding_ admittance - The winding domain admittance
Y_1Voltof a multiwinding transformer, siemens at a one volt winding base (OpenDSSCalcY_Terminal): the pairwise nameplate leakage impedances ofcalc_transformer_leakage_impedancesscaled byphases / S_1, reduced against the last winding (calc_reduced_leakage), inverted, and lifted back through the winding difference incidenceA(rowiisu_i - u_n):Y_1Volt = Aᵀ ZB⁻¹ A. A two winding unit reduces toy · [[1, -1], [-1, 1]].Nonewhen the reduced matrix is exactly singular or not finite: one volt base impedances of high rating units sit far below any fixed pivot threshold, so only exact singularity is refused. - scatter_
primitive_ admittance - Scatter an element’s primitive admittance onto the system positions of
its terminals:
add(terminals[r], terminals[c], primitive[r][c])for every entry, in row major order. The one scatter of a primitive into a nodal system:calc_multiconductor_admittance_matrixreads it over its node references, and a caller indexing terminals its own way reads it over its positions.