Three-Phase Programmable Generator
Generate three-phase signal with programmable time variation of amplitude, phase, frequency, and harmonics
Library
Simscape / Electrical / Specialized Power Systems / Control & Measurements / Pulse & Signal Generators
Simscape / Electrical / Specialized Power Systems / Fundamental Blocks / Power Electronics / Pulse & Signal Generators
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), andTable 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, orModulation.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
1for the harmonic order and1for the sequence to produce a positive-sequence amplitude change without imbalance and without harmonics.Specify
1for the harmonic order and0or2for 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
abcReturns the vectorized signal of phases a, b, and c.
mSimulink® output vector containing eight internal signals.
Signal Signal Names Definition 1-3 Mag_abc Magnitudes of the fundamental component of a, b, c signals 4-6 Phase_abc (deg) Phases of the fundamental component of a, b, c signals (degrees) 7 Freq (Hz) Frequency of the fundamental component of a, b, c signals (hertz) 8 wt (rad) Instantaneous angle of the rotating vector of the positive-sequence component (radians)
Characteristics
| Sample Time |
|
| Scalar Expansion | No |
| Dimensionalized | No |
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.