Main Content

Three-Phase Programmable Generator

Generate three-phase signal with programmable time variation of amplitude, phase, frequency, and harmonics

Library

Simscape / Electrical / Specialized Power Systems / Sources / Signal Generator Sources

  • Three-Phase Programmable Generator block

Description

Use the Three-Phase Programmable Generator block to generate a three-phase sinusoidal signal with time-varying parameters. This vectorized signal usually represents a set of three-phase voltages or currents. You can program the time variation for the amplitude, phase, or frequency of the fundamental component of the signal. In addition, you can program two harmonics and superimpose them on the fundamental signal.

Parameters

Positive-sequence [ Amplitude, Phase (degrees), Freq (Hz) ]

Specify the amplitude (in volts, amperes, or pu), the phase (in degrees), and the frequency (in hertz) of the positive-sequence component of the three-phase signal. Default is [100, 0, 60].

Time variation of

Specify whether you want to program the time variation of the amplitude, phase, or frequency. If you do not want to program a generator time variation, select None (default).

The time variation applies to the three phases of the source except when the Type of variation parameter is set to Table of amplitude-pairs. In that case, you can apply a variation to phase A only.

Type of variation

Specify the type of variation to apply to the amplitude, phase, or frequency specified by the Time variation of parameter. Options include Step, Ramp (default), Modulation (for sinusoidal modulation), and Table of amplitude-pairs (a series of step changes of amplitude or phase at specific times).

Step magnitude

This parameter is visible only when the Type of Variation parameter is set to Step.

Specify the amplitude of the step change of the magnitude of a positive-sequence amplitude (in volts, amperes, or pu), phase (in degrees), or frequency (in hertz). Default is -0.5 .

Rate of change (value/s)

This parameter is visible only when the Type of Variation parameter is set to Ramp.

Specify the rate of change of amplitude (in volts/second, amperes/second, or pu/second), phase (in degrees/second), or frequency (in hertz/second). Default is 10.

Amplitude of the modulation

This parameter is visible only when the Type of Variation parameter is set to Modulation.

Specify the amplitude of the modulation for the amplitude, frequency, or phase, as specified in the Time variation of parameter. Default is 0.3.

Frequency of the modulation (Hz)

This parameter is visible only when the Type of Variation parameter is set to Modulation.

Specify the frequency of the modulation for the amplitude, phase, or frequency, as specified in the Time variation of parameter. Default is 2.

Variation timing (s) [Start, End]

This parameter is visible only when the Type of Variation parameter is set to Step, Ramp, or Modulation.

Specify the time, in seconds, when the programmed time variation takes effect and stops. Default is [0.2 1.2].

Variation on phase A only

This parameter is visible only when the Type of Variation parameter is set to Table of time-amplitude pairs.

When this parameter is selected, the time variation specified by the Amplitude or phase values and Time values parameters is applied on phase A only. Default is selected.

Amplitude or phase values (degrees)

This parameter is visible only when the Type of Variation parameter is set to Table of time-amplitude pairs.

Use this parameter to specify the amplitude or phase values of phase A when Variation on phase A only is selected. Otherwise, use it to specify the positive sequence amplitudes or phase values (in degrees) corresponding to times specified in the Time values parameter. Default is [1 0.2 1.2 1.0].

Time values

This parameter is visible only when the Type of Variation parameter is set to Table of time-amplitude pairs.

Specify the times, in seconds, when the amplitude or phase will change, according to the values specified in the Amplitude or phase values parameter. Default is [0 0.1 0.15 0.2].

Harmonic generation

Select this check box to enable programming of two harmonics that can be superimposed on the fundamental voltage of the source. Default is cleared.

A: [Order (n), Amplitude, Phase (degrees), Seq(0, 1 or 2)]

This parameter is visible only when the Harmonic generation check box is selected.

Specify the order, amplitude, phase, and the type of sequence (1 = positive-sequence; 2 = negative-sequence; 0 = zero-sequence) of the first harmonic to superimpose on the fundamental signal. Default is [3 5 -25 0].

Specify 1 for the harmonic order and 1 for the sequence to produce a positive-sequence amplitude change without imbalance and without harmonics.

Specify 1 for the harmonic order and 0 or 2 for the sequence to produce a signal imbalance without harmonics.

B: [Order (n), Amplitude, Phase (degrees), Seq(0, 1 or 2)]

This parameter is visible only when the Harmonic generation check box is selected. Specify the order, amplitude, phase, and the type of sequence (1 = positive-sequence; 2 = negative-sequence; 0 = zero-sequence) of the second harmonic to superimpose on the fundamental signal. Default is [5 10 35 2].

Harmonic timing (s) [Start, End]

This parameter is visible only when the Harmonic generation check box is selected.

Specify the time, in seconds, when the harmonic generation is superimposed on the fundamental signal and the time when it stops. Default is [ 0.05 99].

Sample time

Specify the sample time of the block, in seconds. Set to 0 to implement a continuous block. Default is 0.

Inputs and Outputs

abc

Returns the vectorized signal of phases a, b, and c.

m

Simulink® output vector containing eight internal signals.

SignalSignal NamesDefinition
1-3Mag_abcMagnitudes of the fundamental component of a, b, c signals
4-6Phase_abc (deg)Phases of the fundamental component of a, b, c signals (degrees)
7Freq (Hz) Frequency of the fundamental component of a, b, c signals (hertz)
8wt (rad)Instantaneous angle of the rotating vector of the positive-sequence component (radians)

Characteristics

Sample Time
  • Specified in the Sample Time parameter

  • Continuous if Sample Time = 0

Scalar ExpansionNo
DimensionalizedNo

Examples

The power_ThreePhaseProgrammableGenerator model shows two applications of the Three-Phase Programmable Generator block.

In the top model, a sinusoidal modulation of amplitude is programmed from 0.1 s to 0.6 s. Then a positive-sequence signal sag is produced from 0.7 s to 0.9 s by adding a positive-sequence harmonic of order 1 with a 180-degree phase-shift.

In the bottom model, a frequency ramp is programmed from 0.1 s to 0.6 s, and then two harmonics (2nd and 5th) are added from 0.7 s to 0.9 s. The magnitude, phase, and frequency of positive-sequence component are measured using a PLL and a Positive-Sequence (PLL-Driven) block. Variations of measured quantities are compared with specified values available at the measurement output (m).

The model sample time is parameterized with variable Ts (default value Ts=50e-6). To simulate the continuous Three-Phase Programmable Generator block, specify Ts = 0 in the MATLAB® Command Window before starting the simulation.

Version History

Introduced in R2013a