Skip to main content

Module sequence

Module sequence 

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

LineVoltageForm
Which phasors VoltageSource::calc_line_to_line_voltage reads a source’s line to line base from.
SequenceRotation
The rotation operator a a symmetrical component transform is built on. The variants are the same transform to within their rounding of sin 120°; the reference tools use several, so a reader reproducing one names the operator it uses.
SequenceThird
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 exact a. The reference engine’s unequal sequence (Z1 ≠ Z2) source matrix uses it; replacing it with sin 120° changes those impedances.

Functions§

calc_balanced_phase_angle
The angle, radians, of phase phase (counted from zero) of a balanced positive sequence set of phases phasors whose first phase is at zero: each phase lags the one before by 2π / phases, stated in (−π, π] (0, −2π/3, +2π/3 for three phases), +0.0 for m = phase mod n zero, formed as −(m · τ / n) for 0 < 2m < n and as (n − m) · τ / n otherwise. Zero for phases zero. 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 OpenDSS VSource forms it: (z₀ + z₁ α^((j−i) mod 3) + z₂ α^((i−j) mod 3)) / 3 with OPENDSS_ALPHA, summed in VSource.RecalcElementData’s order, the α² term, then the α term, then z₀ (Calpha2 * Z2 + Calpha1 * Z1 + Z0 above the diagonal, Calpha2 * Z1 + Calpha1 * Z2 + Z0 below it, DSS C-API 0.14.5), with α² = α · α. The diagonal is (z₂ + z₁ + z₀) / 3. calc_circulant_sequence_from_phase is 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 of calc_circulant_phase_entry over the same OPENDSS_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₂ under rotation, the inverse of calc_sequence_components. The GridLAB-D sequence voltage substation reads it.
calc_phase_from_sequence
The n × n phase matrix of a transposed element from its positive and zero sequence values (calc_sequence_self on the diagonal, calc_sequence_mutual off 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 values diagonal = [d₀, d₁, d₂] (impedances or admittances), under rotation. For an operator whose inverse is conj(A)ᵀ / 3 entry (i, j) is (d₀ + d₁ f + d₂ conj(f)) / 3 with f = p_i conj(p_j) and p = [1, a², a]; for SequenceRotation::OpenDssMathutil it is Σₛ A_is dₛ A⁻¹_sj over 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 phases phasors of one magnitude spaced 2π / phases apart, 2 sin(π / phases) (√3 for three, 2 for two): OpenDSS VSource’s per phase magnitude (kVBase · PerUnit · 1000 / 2 / Sin(180 / Fnphases · π / 180)) and the CIM and MG-RAVENS nominalVoltage read 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, under rotation (for SequenceRotation::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 of calc_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 A of a three phase matrix (rows and columns zero, positive, negative), with A Fortescue’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 as third states.
calc_sequence_self
The self (diagonal) phase entry of a transposed element: (2 z₁ + z₀) / 3, the third taken as third states.