Programmable Voltage Source
A single-phase AC voltage source with the ability to program amplitude, frequency, phase shift and DC offset.
blockType: AcausalElectricPowerSystems.Sources.ProgrammableVoltage
Path in the library:
|
Description
Block Programmable Voltage Source simulates a single-phase AC voltage source with programmable amplitude, frequency, phase shift, and DC offset. Select the external mode to set these values using the input signals M, F, Phi and DC. Higher harmonics and noise can also be included in the voltage source.
Limitations
Modeling with higher harmonics enabled slows down the simulation. If you include harmonics, choose the interval between the calculation steps so that harmonics are generated only at the frequencies you are interested in, and not higher.
Modeling with noise enabled slows down the simulation. If you include noise, choose an interval between the calculation steps so that noise is generated only at the frequencies you are interested in, but not higher.
Ports
Entrance
DC — DC component
scalar
The input port that sets the constant voltage component.
F — frequency, rad
scalar
The input port that sets the frequency.
M — pass amplitude:q[<br>] scalar
The input port that sets the amplitude.
Phi — phase shift, rad
scalar
The input port that sets the phase shift.
Parameters
AC Magnitude
AC magnitude configuration — pass voltage amplitude configuration:q[<br>] Constant (by default) | Ramp | Step | Modulation | External
Setting the AC voltage amplitude
Dependencies
Choosing a value Constant, Ramp, Step or Modulation opens the corresponding parameters.
Choosing a value External opens the input port M.
AC voltage peak magnitude — peak amplitude of the AC voltage
100 V (default)
The peak amplitude of the alternating voltage.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Constant, Ramp, Step or Modulation.
Rate of change — the rate of change of the AC voltage amplitude
1 V/s (default)
The rate of change of the AC voltage amplitude.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Ramp.
Step amplitude — step change of AC voltage amplitude
1 In (default)
The step of changing the amplitude of the alternating voltage.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Step.
Modulation magnitude is the amplitude of the AC voltage modulation
1 In (default)
The amplitule of the AC voltage modulation.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Modulation.
Modulation frequency — frequency of AC voltage modulation
1 Hz (default)
The frequency of AC voltage modulation.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Modulation.
Start time — the start time of the voltage amplitude change
1 s (default)
The time of the beginning of the voltage amplitude change.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Ramp, Step or Modulation.
Stop time — the end time of the voltage amplitude change
2 s (default)
The end time of the voltage amplitude change.
Dependencies
This parameter is available if the AC magnitude configuration parameter is set to Ramp, Step or Modulation.====
Frequency
AC frequency configuration — frequency configuration of the AC voltage
Constant (by default) | Ramp | Step | Modulation | External
Setting the frequency of the alternating voltage.
Dependencies
Choosing a value Constant, Ramp, Step or Modulation opens the corresponding parameters.
Choosing a value External opens the input port F.
AC voltage frequency — AC voltage frequency
50 Hz (default)
The frequency of the alternating voltage.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Constant, Ramp, Step or Modulation.
Rate of change — the rate of change of the AC voltage frequency
1 Hz/s (default)
The rate of change of the AC voltage frequency.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Ramp.
Step amplitude — step of changing the frequency of the alternating voltage
1 Hz (default)
The step of changing the frequency of the alternating voltage.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Step.
Modulation magnitude is the amplitude of the frequency modulation of the AC voltage
1 Hz (default)
The amplitude of the AC voltage frequency modulation.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Modulation.
Modulation frequency — frequency of modulation of the frequency of alternating voltage
1 Hz (default)
The frequency of the AC voltage frequency modulation.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Modulation.
Start time — the start time of the AC voltage frequency change
1 s (default)
The start time of the AC voltage frequency change.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Ramp, Step or Modulation.
Stop time — the end time for changing the frequency of the alternating voltage
2 s (default)
The end time of the AC voltage frequency change.
Dependencies
This parameter is available if the AC frequency configuration parameter is set to Ramp, Step or Modulation.
Phase
AC phase shift configuration — phase shift configuration of the AC voltage
Constant (by default) | Ramp | Step | Modulation | External
Setting the phase shift of the AC voltage.
Dependencies
Choosing a value Constant, Ramp, Step or Modulation opens the corresponding parameters.
Choosing a value External opens the Phi input port.
AC voltage phase shift — phase shift of the AC voltage
0 degrees (default)
Phase shift of the alternating voltage.
Dependencies
This parameter is available if the AC phase shift parameter is set to Constant, Ramp, Step or Modulation.
Rate of change — the rate of change of the phase shift of the alternating voltage
1 deg/s (default)
The rate of change of the phase shift of the alternating voltage.
Dependencies
This parameter is available if the AC phase shift parameter is set to Ramp.
Step amplitude — step of changing the phase shift of the AC voltage
1 degree (default)
The step of changing the phase shift of the alternating voltage.
Dependencies
This parameter is available if the AC phase shift parameter is set to Step.
Modulation magnitude is the amplitude of the phase shift modulation of the AC voltage
1 degree (default)
The amplitude of phase shift modulation of alternating voltage.
Dependencies
This parameter is available if the AC phase shift configuration parameter is set to Modulation.
Modulation frequency — frequency of modulation of phase shift of alternating voltage
1 Hz (default)
Frequency of phase shift modulation of alternating voltage.
Dependencies
This parameter is available if the AC phase shift parameter is set to Modulation.
Start time — the start time of the phase shift change of the AC voltage
1 s (default)
The start time of the phase shift change of the AC voltage.
Dependencies
This parameter is available if the AC phase shift parameter is set to Ramp, Step or Modulation.
Stop time — the end time for changing the phase shift of the AC voltage
2 s (default)
The end time of the phase shift change of the AC voltage.
Dependencies
This parameter is available if the AC phase shift parameter is set to Ramp, Step or Modulation.
DC Voltage
DC voltage configuration — configuration of the constant component of the voltage
Constant (by default) | Ramp | Step | Modulation | External
Setting the constant voltage component.
Dependencies
Choosing a value Constant, Ramp, Step or Modulation opens the corresponding parameters.
Choosing a value External opens the DC input port.
DC voltage — the value of the constant component of the voltage
0 V (default)
The value of the constant voltage component.
Dependencies
This parameter is available if the DC voltage configuration parameter is set to Constant, Ramp, Step or Modulation.
Rate of change — the rate of change of the constant component of the voltage
1 V/s (default)
The rate of change of the constant component of the voltage.
Dependencies
This parameter is available if the DC voltage configuration parameter is set to Ramp.
Step amplitude — the step of changing the constant component of the voltage
1 In (default)
The step of changing the constant component of the voltage.
Dependencies
This parameter is available when the DC voltage configuration parameter is set to Step.
Modulation magnitude is the amplitude of the modulation of the constant component of the voltage
1 In (default)
The amplitude of the modulation of the constant voltage component.
Dependencies
This parameter is available if the DC voltage configuration parameter is set to Modulation.
Modulation frequency — the frequency of modulation of the constant component of the voltage
1 Hz (default)
The frequency of modulation of the constant component of the voltage.
Dependencies
This parameter is available if the DC voltage configuration parameter is set to Modulation.
Start time — the start time of the change in the constant component of the voltage
1 s (default)
The time of the beginning of the change in the constant component of the voltage.
Dependencies
This parameter is available if the DC voltage configuration parameter is set to Ramp, Step or Modulation.
Stop time — the end time of the change in the constant component of the voltage
2 s (default)
The end time of the change in the constant component of the voltage.
Dependencies
This parameter is available if the DC voltage configuration parameter is set to Ramp, Step or Modulation.
Harmonics
Source harmonics — generation of higher harmonics
None (by default) | Generate harmonics
None — there are no higher harmonics, Generate — added to the main one.
Dependencies
Choosing a value Generate harmonics opens the related parameters.
Harmonic orders — harmonic orders of
[5, 7, 11, 13] ( by default)
Harmonic orders.
Dependencies
This parameter is available if the Source harmonics parameter is set to Generate harmonics.
Harmonic to base magnitude ratios — the ratio of the harmonic amplitude to the fundamental amplitude of the
[.1, .1, .1, .1, .1] (default)
Harmonic coefficients. Specify the same number of items as for the Harmonic orders parameter.
Dependencies
This parameter is available if the Source harmonics parameter is set to Generate harmonics.
Harmonic phase shifts — phase shifts of higher harmonics
[0, 0, 0, 0, 0] hail (default)
Phase shifts of higher harmonics. Specify the same number of items as for the Harmonic orders parameter.
Dependencies
This parameter is available if the Source harmonics parameter is set to Generate harmonics.
Start time — start time of harmonic generation
-infs (default)
The start time of harmonic generation.
Dependencies
This parameter is available if the Source harmonics parameter is set to Generate harmonics.
Stop time — the end time of harmonic generation
infs (default)
The end time of harmonic generation.
Dependencies
This parameter is available if the Source harmonics parameter is set to Generate harmonics.