Engee documentation

Programmable Voltage Source (Three-Phase)

Three-phase voltage source with programmable AC amplitude, frequency and phase.

programmable voltage source(three phase)

Description

The Programmable Voltage Source (Three-Phase) unit simulates a three-phase voltage source with programmable AC amplitude, frequency and phase.

To set these values, select the physical input signal parameters M, F and Phi.

You can add harmonics and internal resistance to the voltage source.

The corresponding equations are given in the block Voltage Source (Three-Phase).

Ports

Input

F - frequency
scalar

Input port related to the current frequency.

M is a value
scalar

Input port associated with the current magnitude.

Phi is the phase shift
scalar

Input port related to the phase shift of the current.

Non-directional

n - neutral
electricity

Electrical port, corresponds to the neutral point.

~ is a three-phase port
`three-phase electricity

Three-phase AC voltage port.

Parameters

AC Magnitude

AC magnitude configuration - AC magnitude configuration
Constant (By default) | Ram | Ste | Modulation | External

Adjusts the magnitude of the variable voltage component.

Dependencies

  • The Constant, Ramp, Step or Modulation values of the parameter set the constant, linear, step or modulated signal respectively.

  • The External value of the parameter specifies the physical signal.

Rated voltage (phase-to-phase RMS) - rated AC voltage
`100 V (phase-to-phase RMS)* - nominal AC voltage.

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

Dependencies

To enable this parameter, set Constant, Ramp, Step, or Modulation in the AC magnitude configuration parameter.

Rate of change is the rate of change of the AC voltage
1 V/s (By default).

The rate of change of AC voltage.

Dependencies

To enable this parameter, set Ramp in the AC magnitude configuration parameter.

Step amplitude - AC voltage step amplitude
1 V (By default).

AC voltage step amplitude.

Dependencies

To enable this parameter, set Step in the AC magnitude configuration parameter.

Modulation magnitude - AC voltage modulation magnitude
`1 V (By default).

AC voltage modulation magnitude.

Dependencies

To enable this parameter, set Modulation in the AC magnitude configuration parameter.

Modulation frequency - AC voltage modulation frequency
1 Hz (By default).

AC voltage modulation frequency.

Dependencies

To enable this parameter, set Modulation in the AC magnitude configuration parameter.

Start time - time to switch on the AC voltage source
1 s (By default).

Simulation time of the start of the AC voltage supply.

Dependencies

To enable this parameter, set Ramp, Step or Modulation in the AC magnitude configuration parameter.

Stop time - AC voltage source shutdown time
2 s (By default).

Simulation time of AC voltage supply shutdown.

Dependencies

To enable this parameter, set Ramp, Step or Modulation in the AC magnitude configuration parameter.

Frequency

AC frequency configuration - AC frequency configuration
Constant (By default) | Ramp | Step | Modulation | External

Adjusts the AC frequency.

Dependencies

  • The Constant, Ramp, Step or Modulation values of the parameter set the DC, linear, step or modulated signal respectively.

  • The External value of the parameter specifies the physical signal.

Rated frequency - rated frequency
50 Hz (By default).

Rated frequency.

Dependencies

To enable this parameter, set Constant, Ramp, Step or Modulation in the AC frequency configuration parameter.

Rate of change is the rate of change of AC frequency
1Hz/s (By default).

The rate of change of AC frequency.

Dependencies

To enable this parameter, set Ramp in the AC frequency configuration parameter.

Step amplitude - AC frequency step amplitude
1 Hz (By default).

AC frequency step amplitude.

Dependencies

To enable this parameter, set Step in the AC frequency configuration parameter.

Modulation magnitude - AC frequency modulation frequency
`1 Hz (By default).

AC frequency modulation frequency.

Dependencies

To enable this parameter, set Modulation in the AC frequency configuration parameter.

Start time - time to switch on the AC source at the set frequency
1 s (By default).

Time of modelling of the initial frequency of the alternating current.

Dependencies

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

Stop time - the time for the AC source to switch off at the specified frequency
2 s (By default).

Simulation time for stopping the AC frequency.

Dependencies

To enable this parameter, set Ramp, Step or Modulation in the AC frequency configuration parameter.

Phase

AC phase shift configuration - AC phase shift configuration
By default | | `Ram | `Ste | | `Modulation | `External

AC voltage phase configuration.

Dependencies

  • The Constant, Ramp, Step or Modulation values of the parameter set the DC, linear, step or modulated signal respectively.

  • The External value of the parameter specifies the physical signal.

Phase shift - phase shift
0 deg (by default).

Phase shift in angular units.

Dependencies

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

Rate of change is the rate of change of AC phase shift
1 deg/s (By default).

The rate of change of AC phase shift.

Dependencies

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

Step amplitude - AC phase shift step amplitude
1 deg (By default).

AC phase shift step amplitude.

Dependencies

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

Modulation magnitude - AC phase shift modulation amplitude
1 deg (By default).

AC phase shift modulation magnitude.

Dependencies

To enable this parameter, set Modulation in the AC phase shift configuration parameter.

Modulation frequency - AC phase shift modulation frequency
1 Hz (By default).

AC phase shift modulation frequency.

Dependencies

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

Start time - AC phase shift start time
1 s (By default).

Simulation time for the start of AC phase shift.

Dependencies

To enable this parameter, set Ramp, Step or Modulation in the AC phase shift configuration parameter.

Stop time - AC phase shift start time
2 s (By default).

Simulation time to stop AC phase shift.

To enable this parameter, set Ramp, Step or Modulation in the AC phase shift configuration parameter.

Impedance

Source impedance - source impedance setting method
None (by default) | X/R Ratio | Series R | Series L | Series RL.

Specifies the method for setting the source impedance.

Options:

  • None.

  • `X/R

  • `Series R

  • `Series L

  • `Series RL

Short-circuit power level - short-circuit power
1.6 V*A (by default)

Short-circuit power level.

Dependencies

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

The Source X/R ratio is the ratio of reactive to active impedance
15 (By default).

Complex resistance, i.e. the ratio of reactive resistance to active resistance.

Dependencies

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

Source resistance is the resistance
0.01 Ohm (By default).

Source resistance.

Dependencies

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

Source inductance - inductance
3.97e-4 H (by default).

Source inductance.

Dependencies

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

Parasitic parallel conductance - Parasitic parallel conductance
1e-6 1/Ohm (By default).

Parasitic parallel conductance.

Dependencies

To enable this parameter, set X/R Ratio, Series R or Series RL in the Source impedance parameter.

Harmonics

Source harmonics - generation of higher harmonics
None (By default) | Generate harmonics.

None - no higher harmonics, Generate - added to the source harmonics.

Harmonic orders - order of harmonics
`[5, 7, 11, 13] (By default)'.

Harmonic orders.

Dependencies

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

Harmonic to base magnitude ratios - the ratio of higher harmonics to base magnitude
[.1, .1, .1, .1, .1] (by default).

Ratio of higher harmonics to base magnitude. Specify the same number of elements as specified for Harmonic orders.

Dependencies

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

Harmonic phase shifts - phase shifts of higher harmonics
[0, 0, 0, 0, 0] deg (by default).

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

Dependencies

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

Harmonic sequences - higher harmonic sequences
`[1, 1, 1, 1, 1] (By default).

Higher harmonic sequences.

  • 0 indicates a zero sequence

  • 1 indicates a positive sequence

  • 2 indicates a negative sequence

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

Dependencies

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

Start time - the start time of the source harmonics
-infs (By default).

Simulation time to start initial harmonics.

Dependencies

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

Stop time - stop time of source harmonics
infs (By default).

Simulation time to stop the initial harmonics.

Dependencies

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