# Programmable Voltage Source (Three-Phase)

Three-phase voltage source with optional programmable AC magnitude, frequency, and phase shift

• Library:
• Simscape / Electrical / Sources

## Description

The Programmable Voltage Source (Three-Phase) block models a three-phase voltage source with programmable AC magnitude, frequency, and phase shift. Choose the external mode to specify these quantities by physical input signals M, F, and Phi. You can add harmonics and internal impedance to the voltage source.

For relevant equations, see the Voltage Source (Three-Phase) block.

### Variables

To set the priority and initial target values for the block variables prior to simulation, use the Initial Targets section in the block dialog box or Property Inspector. For more information, see Set Priority and Initial Target for Block Variables.

Nominal values provide a way to specify the expected magnitude of a variable in a model. Using system scaling based on nominal values increases the simulation robustness. Nominal values can come from different sources, one of which is the Nominal Values section in the block dialog box or Property Inspector. For more information, see System Scaling by Nominal Values.

## Ports

### Input

expand all

Physical signal input associated with the frequency.

Physical signal input associated with the magnitude.

Physical signal input associated with the phase shift.

### Conserving

expand all

Electrical conserving port associated with a neutral point.

Expandable electrical conserving three-phase port associated with the AC voltage.

## Parameters

expand all

Whether to model composite or expanded three-phase ports.

Composite three-phase ports represent three individual electrical conserving ports with a single block port. You can use composite three-phase ports to build models that correspond to single-line diagrams of three-phase electrical systems.

Expanded three-phase ports represent the individual phases of a three-phase system using three separate electrical conserving ports.

### AC Magnitude

Configure the magnitude of the AC component of the voltage.

#### Dependencies

Selecting `Constant`, `Ramp`, `Step`, or `Modulation` exposes related parameters.

Selecting `External` exposes a physical signal input port.

Rated AC voltage (phase-to-phase RMS).

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Constant`, `Ramp`, `Step`, or `Modulation`.

AC voltage rate of change.

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Ramp`.

AC voltage step amplitude.

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Step`.

AC voltage modulation magnitude.

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Modulation`.

AC voltage modulation frequency.

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Modulation`.

Simulation time for start of AC voltage.

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Ramp`, `Step`, or `Modulation`.

Simulation time for stop of AC voltage.

#### Dependencies

To enable this parameter, set AC magnitude configuration to `Ramp`, `Step`, or `Modulation`.

### Frequency

Configure the frequency of the AC component of the voltage.

#### Dependencies

Selecting `Constant`, `Ramp`, `Step`, or `Modulation` exposes related parameters.

Selecting `External` exposes a physical signal input port.

Rated frequency.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Constant`, `Ramp`, `Step`, or `Modulation`.

AC frequency rate of change.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Ramp`.

AC frequency step amplitude.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Step`.

AC frequency modulation magnitude.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Modulation`.

AC frequency modulation frequency.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Modulation`.

Simulation time for starting AC frequency.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Ramp`, `Step`, or `Modulation`.

Simulation time for stopping AC frequency.

#### Dependencies

To enable this parameter, set AC frequency configuration to `Ramp`, `Step`, or `Modulation`.

### Phase

Configure the phase of the AC component of the voltage.

#### Dependencies

Selecting `Constant`, `Ramp`, `Step`, or `Modulation` exposes related parameters.

Selecting `External` exposes a physical signal input port.

AC voltage phase shift.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Constant`, `Ramp`, `Step`, or `Modulation`.

AC phase shift rate of change.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Ramp`.

AC phase shift step amplitude.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Step`.

AC phase shift modulation magnitude.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Modulation`.

AC phase shift modulation frequency.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Modulation`.

Simulation time for starting AC phase shift.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Ramp`, `Step`, or `Modulation`.

Simulation time for stopping AC phase shift.

#### Dependencies

To enable this parameter, set AC phase shift configuration to `Ramp`, `Step`, or `Modulation`.

### Impedance

Source impedance configuration.

#### Dependencies

Selecting `X/R Ratio`, `Series R`, ```Series L```, or `Series RL` exposes related parameters.

Short-circuit power level.

#### Dependencies

To enable this parameter, set Source impedance to ```X/R Ratio```.

Source X/R ratio.

#### Dependencies

To enable this parameter, set Source impedance to ```X/R Ratio```.

Source resistance.

#### Dependencies

To enable this parameter, set Source impedance to `Series R` or ```Series RL```.

Source inductance.

#### Dependencies

To enable this parameter, set Source impedance to `Series L` or ```Series RL```.

Parasitic parallel conductance.

#### Dependencies

To enable this parameter, set Source impedance to `X/R Ratio`, `Series L`, or ```Series RL```.

### Harmonics

Configuration for the source harmonics.

#### Dependencies

Selecting `Generate harmonics` exposes related parameters.

Harmonic orders.

#### Dependencies

To enable this parameter, set Source harmonics to `Generate harmonics`.

Harmonic to base magnitude ratios. Specify the same number of elements as is specified for the Harmonic orders parameter.

#### Dependencies

To enable this parameter, set Source harmonics to ```Generate harmonics```.

Harmonic phase shifts. Specify the same number of elements as is specified for the Harmonic orders parameter.

#### Dependencies

To enable this parameter, set Source harmonics to ```Generate harmonics```.

Harmonic sequences:

• `0` indicates zero-sequence

• `1` indicates positive-sequence

• `2` indicates negative-sequence

Specify the same number of elements as is specified for the Harmonic orders parameter.

#### Dependencies

To enable this parameter, set Source harmonics to ```Generate harmonics```.

Simulation time for start of source harmonics.

#### Dependencies

To enable this parameter, set Source harmonics to ```Generate harmonics```.

Simulation time for stop of source harmonics.

#### Dependencies

To enable this parameter, set Source harmonics to ```Generate harmonics```.

## Version History

Introduced in R2019a