pub fn calc_transformer_primitive_admittance<'a>(
network: &MulticonductorNetwork,
transformer: &'a DistTransformer,
) -> Result<TransformerPrimitive<'a>, Error>Expand description
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,
Y_series = Σ_phase Bᵀ Y_1Volt B, B[w][a] = ±1 / (V_coil,w · tap_w)with B the incidence of winding w’s coil on terminal a
(calc_winding_connection) and V_coil its coil voltage
(calc_coil_voltage). A finite WYE neutral impedance stamps once from
the neutral terminal to ground, a solid one is returned in grounded,
and a floating one has no physical grounding branch (calc_winding_neutral_grounding).
The magnetizing branch (calc_transformer_magnetizing) stamps across
each coil of its winding.
Two and three winding units of one to three phases and the BMOPF
center_tap unit are supported. The BMOPF single_phase_autotransformer
states its impedance in ohms
(TransformerLeakageBase::StatedOhms); its primitive is
y · w wᵀ, with w the from winding incidence minus n = 1 / tap times
the to winding incidence, over the order from phase, to phase, from
reference, to reference. The one transformer primitive: the
multiconductor nodal admittance stamps it and the SINCAL writer checks its
candidate against it.
§Errors
A transformer stating no leakage (an ideal coupling, which needs voltage
constraints), another winding count or phase count, a raw OpenDSS
property the typed model does not carry (xrconst, core, a
malformed ppm_antifloat), nameplate, tap, terminal map, connection,
neutral impedance or magnetizing data that is not usable, or a singular
leakage impedance.