Accelerating the pace of engineering and science

# Documentation Center

• Trial Software
• Product Updates

# Three-Phase Programmable Generator

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

## Library

Control and Measurements/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.

## Dialog Box and 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.

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.

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, 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).

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).

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.

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.

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.

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 check box is selected, the time variation specified by the Amplitude or phase values and Time values parameters is applied on phase A only.

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.

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.

Harmonic generation

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

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.

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.

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.

Sample time

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

## 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 parameterContinuous if Sample Time = 0 Scalar Expansion No Dimensionalized No

## Example

The power_ThreePhaseProgrammableGeneratorpower_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.

## See Also

Was this topic helpful?