Expand description
Symmetrical components: the one transform pair between sequence and phase quantities.
A transposed (symmetric) element with positive sequence value z₁ and
zero sequence value z₀ has the phase matrix with self entries
(2 z₁ + z₀) / 3 and mutual entries (z₀ − z₁) / 3; the inverse reads
z₁ = self − mutual and z₀ = self + 2 mutual. A full three phase
matrix or phasor vector transforms with Fortescue’s operator
a = e^{j 2π/3}.
Enums§
- Line
Voltage Form - Which phasors
VoltageSource::calc_line_to_line_voltagereads a source’s line to line base from. - Sequence
Rotation - The rotation operator
aa symmetrical component transform is built on. The variants are the same transform to within their rounding ofsin 120°; the reference tools use several, so a reader reproducing one names the operator it uses. - Sequence
Third - How a sequence to phase expansion takes its third. The spellings are
the same transform and can differ in the last place (and, for
SequenceThird::DivideFirst, in where a large finite value overflows); the reference engines use several, so a reader reproducing one names the order its element class uses.
Constants§
- OPENDSS_
ALPHA - OpenDSS’s rotation operator
DSSGlobals.CALPHA,-0.5 + j 0.866025: rounded to six places, unlike Fortescue’s exacta. The reference engine’s unequal sequence (Z1 ≠ Z2) source matrix uses it; replacing it withsin 120°changes those impedances.
Functions§
- calc_
balanced_ phase_ angle - The angle, radians, of phase
phase(counted from zero) of a balanced positive sequence set ofphasesphasors whose first phase is at zero: each phase lags the one before by2π / phases, stated in(−π, π](0,−2π/3,+2π/3for three phases),+0.0form = phase mod nzero, formed as−(m · τ / n)for0 < 2m < nand as(n − m) · τ / notherwise. Zero forphaseszero. The one balanced phase rotation: the GridLAB-D nominal phasors and sequence voltage substation, the multiconductor OPF start point, the SINCAL multiconductor source writer and the integrated transmission and distribution coupling read it. - calc_
circulant_ phase_ entry - Entry
(i, j),i ≠ j, of the three phase circulant matrix of an element with unequal sequence impedances[z₀, z₁, z₂]as OpenDSSVSourceforms it:(z₀ + z₁ α^((j−i) mod 3) + z₂ α^((i−j) mod 3)) / 3withOPENDSS_ALPHA, summed inVSource.RecalcElementData’s order, theα²term, then theαterm, thenz₀(Calpha2 * Z2 + Calpha1 * Z1 + Z0above the diagonal,Calpha2 * Z1 + Calpha1 * Z2 + Z0below it, DSS C-API 0.14.5), withα² = α · α. The diagonal is(z₂ + z₁ + z₀) / 3.calc_circulant_sequence_from_phaseis its inverse. - calc_
circulant_ sequence_ from_ phase - The sequence impedances
[z₀, z₁, z₂]of a three phase circulant matrix from its first row[z₀₀, z₀₁, z₀₂], the inverse ofcalc_circulant_phase_entryover the sameOPENDSS_ALPHA. - calc_
phase_ components - The three phase phasors
[a, b, c]of zero, positive and negative sequence components[V₀, V₁, V₂]:Va = V₀ + V₁ + V₂,Vb = V₀ + a² V₁ + a V₂,Vc = V₀ + a V₁ + a² V₂underrotation, the inverse ofcalc_sequence_components. The GridLAB-D sequence voltage substation reads it. - calc_
phase_ from_ sequence - The
n × nphase matrix of a transposed element from its positive and zero sequence values (calc_sequence_selfon the diagonal,calc_sequence_mutualoff it). The one sequence to phase expansion: the OpenDSS line code, line and source readers and the pandapower reader read it, for impedance, resistance, reactance and susceptance alike. - calc_
phase_ matrix_ from_ sequence - The three phase matrix
A diag(d₀, d₁, d₂) A⁻¹of an element whose sequence networks are uncoupled, with sequence valuesdiagonal = [d₀, d₁, d₂](impedances or admittances), underrotation. For an operator whose inverse isconj(A)ᵀ / 3entry(i, j)is(d₀ + d₁ f + d₂ conj(f)) / 3withf = p_i conj(p_j)andp = [1, a², a]; forSequenceRotation::OpenDssMathutilit isΣₛ A_is dₛ A⁻¹_sjover its exact inverse. The one sequence diagonal to phase expansion: the SINCAL multiconductor transformer ports (SequenceRotation::Rectangular) and the OpenDSS IndMach012a motor (SequenceRotation::OpenDssMathutil) read it. - calc_
polygon_ chord - The line to line over line to neutral ratio of
phasesphasors of one magnitude spaced2π / phasesapart,2 sin(π / phases)(√3for three,2for two): OpenDSSVSource’s per phase magnitude (kVBase · PerUnit · 1000 / 2 / Sin(180 / Fnphases · π / 180)) and the CIM and MG-RAVENSnominalVoltageread and written over it. The one polygon chord. - calc_
sequence_ components - The zero, positive and negative sequence components of three phase
phasors
[a, b, c]:V₀ = (Va + Vb + Vc)/3,V₁ = (Va + a Vb + a² Vc)/3,V₂ = (Va + a² Vb + a Vc)/3, underrotation(forSequenceRotation::OpenDssMathutil, the rows of its exact inverse). - calc_
sequence_ from_ phase - The positive and zero sequence values
(z₁, z₀)of a transposed element from its self and mutual phase entries:(self − mutual, self + 2 mutual). The one phase to sequence inverse ofcalc_phase_from_sequence: the OpenDSS source and switch writers, the CIM source writer and the SINCAL multiconductor writer read it. - calc_
sequence_ matrix - The sequence matrix
A⁻¹ Z Aof a three phase matrix (rows and columns zero, positive, negative), withAFortescue’s transform. A transposed matrix is diagonal here,diag(z₀, z₁, z₁); its off diagonal entries measure the coupling between sequences. - calc_
sequence_ mutual - The mutual (off diagonal) phase entry of a transposed element:
(z₀ − z₁) / 3, the third taken asthirdstates. - calc_
sequence_ self - The self (diagonal) phase entry of a transposed element:
(2 z₁ + z₀) / 3, the third taken asthirdstates.