Engee documentation

Programmable Voltage Source

Single-phase AC voltage source with programmable amplitude, frequency, phase shift and DC offset.

programmable voltage source

Description

The Programmable Voltage Source unit simulates a single-phase AC voltage source with programmable amplitude, frequency, phase shift and DC offset. Select external mode to set these values using M, F, Phi and DC input signals. Higher harmonics and noise can also be included in the voltage source.

Limitations

Modelling with higher harmonics included slows down the simulation. If you include harmonics, choose the interval between calculation steps so that harmonics are generated only at the frequencies of interest and not above.

Modelling with noise enabled slows down the simulation. If you include noise, select the interval between calculation steps so that noise is generated only at the frequencies of interest and not above.

Ports

Input

DC - DC component
scalar

An input port that specifies the DC component of the voltage.

F is the frequency, rad
scalar

Input port that sets the frequency.

M - amplitude
scalar

Input port that sets the amplitude.

Phi - phase shift, rad
scalar

Input port that specifies the phase shift.

Non-directional

+ - positive
electricity

The electrical port corresponding to the positive terminal of the source.

- - negative
electricity

The electrical port corresponding to the negative terminal of the source.

Parameters

AC Magnitude

AC magnitude configuration - voltage magnitude configuration
Constant (by default) | Ramp | Step | Modulation | External

Adjusting the amplitude of the AC voltage

Dependencies

Selecting Constant, Ramp, Step or Modulation opens the corresponding parameters.

Selecting External opens the M input port.

AC voltage peak magnitude - AC voltage peak magnitude
100 V (by default).

AC voltage peak magnitude.

Dependencies

This parameter is available when AC magnitude configuration is set to Constant, Ramp, Step or Modulation.

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

The rate of change of the AC voltage amplitude.

Dependencies

This parameter is available when AC magnitude configuration is set to Ramp.

Step amplitude - step of change of AC voltage amplitude
1 V (by default).

Step of change of the variable voltage amplitude.

Dependencies

This parameter is available when the AC magnitude configuration parameter is set to Step.

Modulation magnitude - AC voltage modulation amplitude
1 V (by default).

Variable voltage modulation amplitude.

Dependencies

This parameter is available when AC magnitude configuration is set to Modulation.

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

Modulation frequency of the alternating voltage.

Dependencies

This parameter is available when AC magnitude configuration is set to Modulation.

Start time - start time of the voltage amplitude change
`1 s (by default).

Start time of voltage amplitude change.

Dependencies

This parameter is available when AC magnitude configuration is set to Ramp, Step or Modulation.

Stop time - time for the end of the voltage amplitude change
`2 s (By default)

Time of the end of the voltage amplitude change.

Dependencies

This parameter is available when AC magnitude configuration is set to Ramp, Step or Modulation.====

Frequency

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

Frequency configuration of the AC voltage.

Dependencies

Selecting Constant, Ramp, Step or Modulation opens the corresponding parameters.

Selecting External opens the F input port.

AC voltage frequency - AC voltage frequency
50 Hz (By default)

AC voltage frequency.

Dependencies

This parameter is available when AC frequency configuration is set to Constant, Ramp, Step or Modulation.

Rate of change - the rate of change of the AC voltage frequency
`1 Hz/s (by default).

The rate of change of the AC voltage frequency.

Dependencies

This parameter is available when AC frequency configuration is set to Ramp.

Step amplitude - step amplitude of the AC voltage frequency change
1 Hz (By default).

Step amplitude of the AC voltage frequency change.

Dependencies

This parameter is available when AC frequency configuration is set to Step.

Modulation magnitude - frequency modulation amplitude of the AC voltage frequency
1 Hz (By default).

The amplitude of the AC voltage frequency modulation.

Dependencies

This parameter is available when AC frequency configuration is set to Modulation.

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

Frequency modulation frequency of the AC voltage frequency.

Dependencies

This parameter is available when AC frequency configuration is set to Modulation.

Start time - start time of AC voltage frequency change
`1 s (by default).

The start time of AC voltage frequency change.

Dependencies

This parameter is available when AC frequency configuration is set to Ramp, Step or Modulation.

Stop time - time of end of AC voltage frequency change
2 s (By default).

End time of AC voltage frequency change.

Dependencies

This parameter is available when AC frequency configuration is set to Ramp, Step or Modulation.

Phase

AC phase shift configuration - AC voltage phase shift configuration
Constant (By default) | Ramp | Step | Modulation | External

Adjust the phase shift configuration of the AC voltage.

Dependencies

Selecting Constant, Ramp, Step or Modulation opens the corresponding parameters.

Selecting External opens the Phi input port.

AC voltage phase shift - AC voltage phase shift
0 deg (by default)

AC voltage phase shift.

Dependencies

This parameter is available when AC phase shift is set to Constant, Ramp, Step or Modulation.

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

The rate of change of the phase shift of the AC voltage.

Dependencies

This parameter is available when AC phase shift is set to Ramp.

Step amplitude - step of AC voltage phase shift change
1 deg (by default).

Step of change of phase shift variation of AC voltage.

Dependencies

This parameter is available when the AC phase shift parameter is set to Step.

Modulation magnitude - modulation amplitude of AC voltage phase shift modulation
1 deg (by default).

The amplitude of the AC voltage phase shift modulation.

Dependencies

This parameter is available when the AC phase shift configuration parameter is set to Modulation.

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

Frequency of AC voltage phase shift modulation.

Dependencies

This parameter is available when AC phase shift is set to Modulation.

Start time - start time of AC phase shift change
`1 s (by default).

The start time of the AC voltage phase shift change.

Dependencies

This parameter is available when AC phase shift is set to Ramp, Step or Modulation.

Stop time - end time of AC phase shift change
`2 s (by default).

End time of AC voltage phase shift change.

Dependencies

This parameter is available when AC phase shift is set to Ramp, Step or Modulation.

DC Voltage

DC voltage configuration - DC voltage configuration
Constant (By default) | Ramp | Step | Modulation | External

Voltage constant configuration.

Dependencies

Selecting Constant, Ramp, Step or Modulation opens the corresponding parameters.

Selecting External opens the DC input port.

DC voltage - value of the constant component of voltage
0 V (by default)

The value of the voltage constant component.

Dependencies

This parameter is available when DC voltage configuration is set to Constant, Ramp, Step or Modulation.

Rate of change - rate of change of the constant component of voltage
1 V/s (By default).

Rate of change of the voltage constant component.

Dependencies

This parameter is available when DC voltage configuration is set to Ramp.

Step amplitude - step of change of the voltage constant component
1 V (by default).

Step of change of constant component of voltage.

Dependencies

This parameter is available when DC voltage configuration is set to Step.

Modulation magnitude - modulation amplitude of the constant voltage component
1 V (by default).

Modulation amplitude of the voltage constant component.

Dependencies

This parameter is available when DC voltage configuration is set to Modulation.

Modulation frequency - modulation frequency of the voltage constant component
1 Hz (By default).

Modulation frequency of the voltage constant component.

Dependencies

This parameter is available when DC voltage configuration is set to Modulation.

Start time - time of the start of the change of the voltage constant component
`1 s (by default).

Start time of the voltage constant component change.

Dependencies

This parameter is available when DC voltage configuration is set to Ramp, Step or Modulation.

Stop time - time of the end of the voltage constant component change
2 s (By default).

Time of the end of change of the voltage constant component.

Dependencies

This parameter is available when DC voltage configuration is set to Ramp, Step or Modulation.

Harmonics

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

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

Dependencies

Selecting Generate harmonics opens the related parameters.

Harmonic orders - harmonic orders
[5, 7, 11, 13] (by default)

Harmonic orders.

Dependencies

This parameter is available when Source harmonics is set to Generate harmonics.

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

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

Dependencies

This parameter is available when Source harmonics is set to Generate harmonics.

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

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

Dependencies

This parameter is available when Source harmonics is set to Generate harmonics.

Start time - the time to start generating harmonics
-infs (by default).

Start time of harmonic generation.

Dependencies

This parameter is available when Source harmonics is set to Generate harmonics.

Stop time - end time of harmonics generation
infs (By default).

Harmonic generation stop time.

Dependencies

This parameter is available when Source harmonics is set to Generate harmonics.