Skip to main content

Module transformer

Module transformer 

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

TransformerMagnetizing
A transformer’s magnetizing branch: the per coil admittance, siemens, stamped across each coil of one winding.
TransformerPrimitive
A finite leakage transformer’s primitive admittance, siemens, over its physical terminals.

Enums§

TransformerLeakageBase
The unit system a transformer states its leakage in, which calc_transformer_leakage_impedances reads.
WindingNeutralGrounding
How a winding’s neutral is grounded, as the source states it.

Functions§

calc_coil_shunt_primitive
The primitive of an admittance y across 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_ratio over 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 the v_nom a BMOPF n-winding unit states.
calc_coil_voltage_ratio
The ratio of a winding’s rated voltage (v_ref) to its coil voltage: √3 for 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 forms v_ref from a coil voltage v_nom with it, and calc_coil_voltage divides by it.
calc_delta_direction
The orientation of a DELTA winding’s coil ring, +1 (phase k to phase k + 1) or -1 (phase k to phase k - 1):
calc_reduced_leakage
The pairwise leakage of calc_transformer_leakage_impedances reduced against the reference winding 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_neutral and x_neutral state, 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 (NaN parts for a nonfinite one). The one neutral grounding rule: calc_winding_neutral_grounding checks 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 a and b, on a per winding base B_a and a reference base B_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_shift of winding 1).
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.
calc_winding_connection
The coils of one winding as channels over its terminal map, in phase order (calc_element_connection with 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 of calc_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 power power / 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. None for an unusable voltage or power.
calc_winding_neutral_grounding
A winding’s neutral grounding, calc_stated_neutral_grounding checked 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_admittance refuses 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.