Expand description
Transformer winding physics: the pairwise leakage and its reduction, each winding’s coil voltage, connection and delta orientation, the neutral grounding and magnetizing branch a unit states, and the finite leakage primitive admittance over its physical terminals.
Every multiconductor calculation reads its transformer quantities here: the nodal admittance and its ideal constraints, the multiconductor OPF descriptor, the multiconductor to balanced lowering and the SINCAL writer’s expected primitive.
Structs§
- Transformer
Magnetizing - A transformer’s magnetizing branch: the per coil admittance, siemens, stamped across each coil of one winding.
- Transformer
Primitive - A finite leakage transformer’s primitive admittance, siemens, over its physical terminals.
Enums§
- Transformer
Leakage Base - The unit system a transformer states its leakage in, which
calc_transformer_leakage_impedancesreads. - Winding
Neutral Grounding - How a winding’s neutral is grounded, as the source states it.
Functions§
- calc_
coil_ shunt_ primitive - The primitive of an admittance
yacross one coil:y · [[1, -1], [-1, 1]]over its two terminals, or[[y]]when the coil returns through ground. The one coil shunt stamp: the transformer primitive’s magnetizing branch and the multiconductor OPF’s core and neutral shunts read it. - calc_
coil_ voltage - A winding’s coil voltage, volts: line to neutral (
v_ref / √3) for a polyphase WYE winding, the rated voltage otherwise (calc_coil_voltage_ratioover the unit’s phases). Times the winding’s tap, it is the coil’s turns in volts, the quantity every turns ratio of the unit is formed from, and thev_noma BMOPF n-winding unit states. - calc_
coil_ voltage_ ratio - The ratio of a winding’s rated voltage (
v_ref) to its coil voltage:√3for a WYE winding of a two or three phase unit (a line to line rating over a line to neutral coil), one otherwise. The BMOPF reader formsv_reffrom a coil voltagev_nomwith it, andcalc_coil_voltagedivides by it. - calc_
delta_ direction - The orientation of a DELTA winding’s coil ring,
+1(phasekto phasek + 1) or-1(phasekto phasek - 1): - calc_
reduced_ leakage - The pairwise leakage of
calc_transformer_leakage_impedancesreduced against thereferencewinding to the winding difference impedance matrix, over every other winding in winding order: - calc_
regulator_ series_ ohms - A regulator’s stated series impedance, ohms on each side:
[r_series_from, x_series_from, r_series_to, x_series_to], each zero when omitted. The one reading of these extras: the stated ohm leakage (TransformerLeakageBase::StatedOhms) and the multiconductor OPF tap rows read it. - calc_
stated_ neutral_ grounding - The neutral grounding a winding’s
r_neutralandx_neutralstate, OpenDSS’s reading: unstated when both are omitted, floating for a negative resistance, solid when both are zero (an omitted one reads zero), else the admittance of the stated impedance (NaNparts for a nonfinite one). The one neutral grounding rule:calc_winding_neutral_groundingchecks it, and the MG-RAVENS and BMOPF writers and the multiconductor ideal transformer profile read it as stated. - 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_ magnetizing - The magnetizing branch a transformer states, in one of three spellings:
- calc_
transformer_ phase_ shift - The positive sequence phase shift of a two winding unit, degrees: the
angle by which the first winding’s voltage leads the second’s
(
calc_winding_phase_shiftof winding 1). - 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. - calc_
winding_ connection - The coils of one winding as channels over its terminal map, in phase
order (
calc_element_connectionwith the unit’s phase count): each polyphase WYE coil from its phase terminal to the neutral (to ground when the map states no neutral), each DELTA coil around the ring in the orientation ofcalc_delta_direction, and a single phase coil across its two terminals (to ground for one). - calc_
winding_ impedance_ base - A winding’s impedance base, ohms: its coil voltage
(
calc_coil_voltage) squared over its per phase powerpower / phases(calc_winding_phase_count),powerio_core::electrical::calc_impedance_base. The base a BMOPF n-winding unit states its winding resistances (on the winding’s rating) and pair reactances (on the unit’s power base) on, and the multiconductor OPF descriptor’s reference base.Nonefor an unusable voltage or power. - calc_
winding_ neutral_ grounding - A winding’s neutral grounding,
calc_stated_neutral_groundingchecked for the transformer primitive and the multiconductor OPF descriptor. - calc_
winding_ phase_ count - The number of phases a winding’s per phase power base divides over: a WYE winding’s terminals less its neutral (mapped last, as the BMOPF and OpenDSS readers state it), at least one; one for a two terminal DELTA winding (a single coil); one per terminal of a DELTA ring.
- is_
transformer_ regulator - Whether the unit is a BMOPF regulator (a single phase autotransformer or an open delta regulator leg), whose tap is the regulated over source voltage ratio.
- transformer_
extra_ number - A transformer extra as a number: typed producers write numbers and the DSS reader keeps written extras as text. A present value that is neither reads as NaN, so it reaches the caller’s finite value checks rather than becoming an omitted zero. The one reader of a transformer’s numeric extras.
- transformer_
states_ no_ leakage - Whether
calc_transformer_primitive_admittancerefuses this transformer for stating no leakage at all: no short circuit reactance and no winding resistance, or, for a single phase autotransformer, no stated series impedance. Such a unit is an ideal coupling, which needs exact voltage constraints rather than an admittance.