Three-Phase Programmable Generator

(To be removed) Generate three-phase signal with programmable time variation of amplitude, phase, frequency, and harmonics

The Specialized Power Systems library will be removed in R2026a. Use the Simscape™ Electrical™ blocks and functions instead. For more information on updating your models, see Upgrade Specialized Power System Models to use Simscape Electrical Blocks.

Library

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

• 

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.

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	Specified in the Sample Time parameter Continuous if Sample Time = 0
Scalar Expansion	No
Dimensionalized	No