Main Content

Programmable Voltage Source (Three-Phase)

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

  • Programmable Voltage Source (Three-Phase) block

Libraries:
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 before 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. You can specify nominal values using different sources, including 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.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2019a