Skip to main content

Module multiconductor

Module multiconductor 

Source
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§

AugmentedSystem
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.
DistNode
One voltage unknown: a bus terminal, by stable identity.
GroundedNeutral
A transformer neutral the source grounds solidly: an exact zero voltage at (bus, terminal), not an admittance.
MulticonductorAdmittance
The assembled multiconductor nodal system.
MulticonductorNodeIndex
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).
NetworkPrimitives
Every admittance element of a network with the exact constraints it leaves to the caller: calc_passive_primitives.
PassivePrimitive
One passive element’s primitive admittance, siemens, with the bus terminal behind each primitive row.
TransformerPrimitive
A finite leakage transformer’s primitive admittance, siemens, over its physical terminals.

Enums§

NodeRef
Where a bus terminal lands in the nodal system.
PassiveFamily
The passive element family behind a PassivePrimitive.
TransformerLeakageBase
The unit system a transformer states its leakage in, which calc_transformer_leakage_impedances reads.

Functions§

assemble_multiconductor_admittance
calc_multiconductor_admittance_matrix over element primitives the caller already holds from calc_passive_primitives of 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: j times 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_from then terminal_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_matrix scatters it over its node references, and a caller indexing terminals its own way scatters it over its positions with scatter_primitive_admittance.
calc_shunt_primitive_admittance
The primitive admittance of a shunt element, siemens, over its terminal_map: its stated G + j B.
calc_transformer_leakage_impedances
The pairwise leakage impedances of a multiwinding transformer, referred to the first winding: for windings a and b, on a per winding base B_a and a reference base B_ref,
calc_transformer_primitive_admittance
The primitive admittance of a finite leakage transformer, siemens, over its physical terminals, following the OpenDSS CalcY_Terminal path: the winding domain Y_1Volt (calc_transformer_winding_admittance, the inverse of the reduced pairwise leakage of calc_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_1Volt of a multiwinding transformer, siemens at a one volt winding base (OpenDSS CalcY_Terminal): the pairwise nameplate leakage impedances of calc_transformer_leakage_impedances scaled by phases / S_1, reduced against the last winding (calc_reduced_leakage), inverted, and lifted back through the winding difference incidence A (row i is u_i - u_n): Y_1Volt = Aᵀ ZB⁻¹ A. A two winding unit reduces to y · [[1, -1], [-1, 1]]. None when 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_matrix reads it over its node references, and a caller indexing terminals its own way reads it over its positions.