Skip to main content

calc_transformer_primitive_admittance

Function calc_transformer_primitive_admittance 

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