Programmable Voltage Source (Three-Phase)

Three-phase voltage source with programmable value of amplitude, frequency and phase of alternating current.

blockType: AcausalElectricPowerSystems.Sources.ThreePhaseProgrammableVoltage

Path in the library:

/Physical Modeling/Electrical/Sources/Programmable Voltage Source (Three-Phase)

Description

Block Programmable Voltage Source (Three-Phase) simulates a three-phase voltage source with programmable values of amplitude, frequency and phase of alternating current.

To set these values, select the input 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).

Variables

Use a group of parameters Initial Targets to set the priority and initial target values for the block parameter variables before modeling. For more information, see Configuring physical blocks using target values.

Ports

Conserving

# ~ — three-phase port
electricity

Details

Three-phase AC voltage port.

Program usage name

port

# n — neutral
electricity

Details

Electrical port, corresponds to the neutral point.

Program usage name

n

Input

# Phi — phase shift
scalar

Details

The input port associated with the phase shift of the current.

Data types	`Float64`
Complex numbers support	I don’t

# F — Frequency
scalar

Details

The input port associated with the frequency of the current.

Data types	`Float64`
Complex numbers support	I don’t

# M — amplitude
scalar

Details

The input port associated with the amplitude of the current.

Data types	`Float64`
Complex numbers support	I don’t

Parameters

AC Magnitude

# AC magnitude configuration — configuration of the AC current value
Constant | Ramp | Step | Modulation | External

Details

Setting the value of the variable voltage component.

Dependencies

Values Constant, Ramp, Step or Modulation The parameters are set to a constant, linear, step, or modulated signal, respectively.
Meaning External The parameter specifies the physical signal.

Values	`Constant` \| `Ramp` \| `Step` \| `Modulation` \| `External`
Default value	`Constant`
Program usage name	`V_type`
Evaluatable	No

# Rated voltage (phase-to-phase RMS) — Rated AC voltage
V | uV | mV | kV | MV

Details

Rated AC voltage (RMS value in phase).

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Constant, Ramp, Step, or Modulation.

Units	`V` \| `uV` \| `mV` \| `kV` \| `MV`
Default value	`100.0 V`
Program usage name	`V_rated`
Evaluatable	Yes

# Rate of change — rate of change of AC voltage
V/s | V/us

Details

The rate of change of the AC voltage.

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Ramp.

Units	`V/s` \| `V/us`
Default value	`1.0 V/s`
Program usage name	`V_ramp`
Evaluatable	Yes

# Step amplitude — the amplitude of the AC voltage step
V | uV | mV | kV | MV

Details

The amplitude of the step of the alternating voltage of the alternating current.

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Step.

Units	`V` \| `uV` \| `mV` \| `kV` \| `MV`
Default value	`1.0 V`
Program usage name	`V_step`
Evaluatable	Yes

# Modulation magnitude — the magnitude of the AC voltage modulation
V | uV | mV | kV | MV

Details

The magnitude of the AC voltage modulation.

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Modulation.

Units	`V` \| `uV` \| `mV` \| `kV` \| `MV`
Default value	`1.0 V`
Program usage name	`V_modulation_mag`
Evaluatable	Yes

# Modulation frequency — frequency of AC voltage modulation
Hz | kHz | MHz | GHz

Details

Frequency of AC voltage modulation.

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Modulation.

Units	`Hz` \| `kHz` \| `MHz` \| `GHz`
Default value	`1.0 Hz`
Program usage name	`V_modulation_frequency`
Evaluatable	Yes

# Start time — the time of switching on the AC voltage source
s | ns | us | ms | min | hr | d

Details

The simulation time for the start of the AC voltage supply.

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Ramp, Step or Modulation.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`1.0 s`
Program usage name	`V_start_time`
Evaluatable	Yes

# Stop time — the time of disconnection of the AC voltage source
s | ns | us | ms | min | hr | d

Details

The simulation time for switching off the AC power supply.

Dependencies

To use this parameter, set for the parameter AC magnitude configuration meaning Ramp, Step or Modulation.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`2.0 s`
Program usage name	`V_stop_time`
Evaluatable	Yes

Frequency

# AC frequency configuration — AC frequency configuration
Constant | Ramp | Step | Modulation | External

Details

Setting the AC frequency.

Dependencies

Values Constant, Ramp, Step or Modulation The parameters are set as a constant, linear, step, or modulated signal, respectively.
Meaning External The parameter specifies the physical signal.

Values	`Constant` \| `Ramp` \| `Step` \| `Modulation` \| `External`
Default value	`Constant`
Program usage name	`f_type`
Evaluatable	No

# AC voltage frequency — frequency of alternating current
Hz | kHz | MHz | GHz

Details

The frequency of the alternating voltage.

Dependencies

To use this parameter, set for the parameter AC frequency configuration meaning Constant, Ramp, Step or Modulation.

Units	`Hz` \| `kHz` \| `MHz` \| `GHz`
Default value	`50.0 Hz`
Program usage name	`f`
Evaluatable	Yes

# Rate of change — the rate of change of the alternating current frequency
Hz^2 | GHz^2 | MHz^2 | kHz^2 | Hz/s

Details

The rate of change of the alternating current frequency.

Dependencies

To use this parameter, set for the parameter AC frequency configuration meaning Ramp.

Units	`Hz^2` \| `GHz^2` \| `MHz^2` \| `kHz^2` \| `Hz/s`
Default value	`1.0 Hz/s`
Program usage name	`f_ramp`
Evaluatable	Yes

# Step amplitude — the amplitude of the AC frequency step
Hz | kHz | MHz | GHz

Details

The amplitude of the pitch of the alternating current frequency.

Dependencies

To use this parameter, set for the parameter AC frequency configuration meaning Step.

Units	`Hz` \| `kHz` \| `MHz` \| `GHz`
Default value	`1.0 Hz`
Program usage name	`f_step`
Evaluatable	Yes

# Modulation magnitude — amplitude of AC voltage frequency modulation
Hz | kHz | MHz | GHz

Details

The amplitude of the AC voltage frequency modulation.

Dependencies

To use this parameter, set for the parameter AC frequency configuration meaning Modulation.

Units	`Hz` \| `kHz` \| `MHz` \| `GHz`
Default value	`1.0 Hz`
Program usage name	`f_modulation_mag`
Evaluatable	Yes

# Modulation frequency — frequency of frequency modulation of alternating current
Hz | kHz | MHz | GHz

Details

Frequency of frequency modulation of alternating current.

Dependencies

To use this parameter, set for the parameter AC frequency configuration meaning Modulation.

Units	`Hz` \| `kHz` \| `MHz` \| `GHz`
Default value	`1.0 Hz`
Program usage name	`f_modulation_frequency`
Evaluatable	Yes

# Start time — the time when the AC source is switched on at the set frequency
s | ns | us | ms | min | hr | d

Details

The simulation time of the initial AC frequency.

Dependencies

To use this parameter, set to AC frequency configuration meaning Ramp, Step or Modulation.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`1.0 s`
Program usage name	`f_start_time`
Evaluatable	Yes

# Stop time — the time of switching off the AC power source at a given frequency
s | ns | us | ms | min | hr | d

Details

Simulation time to stop the AC frequency.

Dependencies

To use this parameter, set for the parameter AC frequency configuration meaning Ramp, Step or Modulation.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`2.0 s`
Program usage name	`f_stop_time`
Evaluatable	Yes

Phase

# AC phase shift configuration — AC phase shift configuration
Constant | Ramp | Step | Modulation | External

Details

Setting the phase of the AC voltage.

Dependencies

Values Constant, Ramp, Step or Modulation The parameters are set to a constant, linear, step, or modulated signal, respectively.
Meaning External The parameter specifies the physical signal.

Values	`Constant` \| `Ramp` \| `Step` \| `Modulation` \| `External`
Default value	`Constant`
Program usage name	`shift_type`
Evaluatable	No

# AC voltage phase shift — phase shift
rad | deg | rev | mrad | arcsec | arcmin | gon

Details

Phase shift in degrees.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Constant, Ramp, Step or Modulation.

Units	`rad` \| `deg` \| `rev` \| `mrad` \| `arcsec` \| `arcmin` \| `gon`
Default value	`0.0 deg`
Program usage name	`shift`
Evaluatable	Yes

Details

The rate of change of the phase shift of alternating current.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Ramp.

Units	`rad/s` \| `deg/s` \| `rad/min` \| `deg/min` \| `rpm` \| `rps`
Default value	`1.0 deg/s`
Program usage name	`shift_ramp`
Evaluatable	Yes

# Step amplitude — the amplitude of the phase shift step of alternating current
rad | deg | rev | mrad | arcsec | arcmin | gon

Details

The amplitude of the phase shift step of the alternating current.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Step.

Units	`rad` \| `deg` \| `rev` \| `mrad` \| `arcsec` \| `arcmin` \| `gon`
Default value	`1.0 deg`
Program usage name	`shift_step`
Evaluatable	Yes

# Modulation magnitude — amplitude of phase shift modulation of alternating current
rad | deg | rev | mrad | arcsec | arcmin | gon

Details

The amplitude of the phase shift modulation of alternating current.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Modulation.

Units	`rad` \| `deg` \| `rev` \| `mrad` \| `arcsec` \| `arcmin` \| `gon`
Default value	`1.0 deg`
Program usage name	`shift_modulation_mag`
Evaluatable	Yes

# Modulation frequency — frequency of phase shift modulation of alternating current
Hz | kHz | MHz | GHz

Details

Frequency of phase shift modulation of alternating current.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Modulation.

Units	`Hz` \| `kHz` \| `MHz` \| `GHz`
Default value	`1.0 Hz`
Program usage name	`shift_modulation_frequency`
Evaluatable	Yes

# Start time — the time of the beginning of the phase shift change of the alternating current
s | ns | us | ms | min | hr | d

Details

The time of the beginning of the phase shift change of the alternating current.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Ramp, Step or Modulation.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`1.0 s`
Program usage name	`shift_start_time`
Evaluatable	Yes

# Stop time — The end time of the alternating current phase shift change
s | ns | us | ms | min | hr | d

Details

The end time of the alternating current phase shift change.

Dependencies

To use this parameter, set for the parameter AC phase shift configuration meaning Ramp, Step or Modulation.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`2.0 s`
Program usage name	`shift_stop_time`
Evaluatable	Yes

Impedance

# Source impedance — the method of setting the source impedance
None | X/R Ratio | Series R | Series L | Series RL

Details

Sets the method for setting the source impedance:

None
X/R Ratio
Series R
Series L
Series RL

Values	`None` \| `X/R Ratio` \| `Series R` \| `Series L` \| `Series RL`
Default value	`X/R Ratio`
Program usage name	`impedance_option`
Evaluatable	No

# Short-circuit power level — short circuit power
W | uW | mW | kW | MW | GW | V*A | HP_DIN

Details

The power level of the short circuit.

Dependencies

To use this parameter, set for the parameter Source impedance meaning X/R Ratio.

Units	`W` \| `uW` \| `mW` \| `kW` \| `MW` \| `GW` \| `V*A` \| `HP_DIN`
Default value	`1e6 V*A`
Program usage name	`S_short_circuit`
Evaluatable	Yes

# Source X/R ratio — the ratio of reactance to active resistance

Details

Complex resistance, that is, the ratio of reactance to active resistance.

Dependencies

To use this parameter, set for the parameter Source impedance meaning X/R Ratio.

Default value	`15`
Program usage name	`ratio_X_to_R`
Evaluatable	Yes

# Source resistance — resistance
Ohm | mOhm | kOhm | MOhm | GOhm

Details

The resistance of the source.

Dependencies

To use this parameter, set for the parameter Source impedance meaning Series R or Series RL.

Units	`Ohm` \| `mOhm` \| `kOhm` \| `MOhm` \| `GOhm`
Default value	`0.01 Ohm`
Program usage name	`R`
Evaluatable	Yes

# Source inductance — inductance
H | nH | uH | mH

Details

The inductance of the source.

Dependencies

To use this parameter, set for the parameter Source impedance meaning Series R or Series RL.

Units	`H` \| `nH` \| `uH` \| `mH`
Default value	`0.000397 H`
Program usage name	`L`
Evaluatable	Yes

# Parasitic parallel conductance — parasitic parallel conduction
S | nS | uS | mS | 1/Ohm

Details

Parasitic parallel conduction.

Dependencies

To use this parameter, set for the parameter Source impedance meaning X/R Ratio, Series R or Series RL.

Units	`S` \| `nS` \| `uS` \| `mS` \| `1/Ohm`
Default value	`1e-6 1/Ohm`
Program usage name	`G_parasitic`
Evaluatable	Yes

Harmonics

# Source harmonics — generation of higher harmonics

Details

If this option is unchecked, then there are no higher harmonics.

If this option is selected, the higher harmonics are added to the main harmonics.

Default value	`false (switched off)`
Program usage name	`harmonic_option`
Evaluatable	No

# Harmonic orders — harmonic order

Details

Harmonic orders.

Dependencies

To use this option, check the box Source harmonics.

Default value	`[5, 7, 11, 13]`
Program usage name	`harmonic_orders`
Evaluatable	Yes

# Harmonic magnitude to peak magnitude ratios — the ratio of harmonic amplitudes to the amplitude of the fundamental harmonic

Details

The ratio of the higher harmonics to the base value. Specify the same number of elements as specified for the parameter Harmonic orders.

Dependencies

To use this option, check the box Source harmonics.

Default value	`[0.1, 0.1, 0.1, 0.1]`
Program usage name	`harmonic_ratios`
Evaluatable	Yes

# Harmonic phase shifts — phase shifts of higher harmonics
rad | deg | rev | mrad | arcsec | arcmin | gon

Details

Phase shifts of higher harmonics. Specify the same number of elements as specified for the parameter Harmonic orders.

Dependencies

To use this option, check the box Source harmonics.

Units	`rad` \| `deg` \| `rev` \| `mrad` \| `arcsec` \| `arcmin` \| `gon`
Default value	`[0, 0, 0, 0] deg`
Program usage name	`harmonic_shifts`
Evaluatable	Yes

# Harmonic sequences — sequences of higher harmonics

Details

Sequences of higher harmonics.

0 indicates the null sequence
1 indicates a positive sequence
2 indicates a negative sequence

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

Dependencies

To use this option, check the box Source harmonics.

Default value	`[1, 1, 1, 1]`
Program usage name	`harmonic_sequences`
Evaluatable	Yes

# Start time — harmonic generation start time
s | ns | us | ms | min | hr | d

Details

The start time of harmonic generation.

Dependencies

To use this option, check the box Source harmonics.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`-Inf s`
Program usage name	`harmonics_start_time`
Evaluatable	Yes

# Stop time — the end time of harmonic generation
s | ns | us | ms | min | hr | d

Details

The end time of harmonic generation.

Dependencies

To use this option, check the box Source harmonics.

Units	`s` \| `ns` \| `us` \| `ms` \| `min` \| `hr` \| `d`
Default value	`Inf s`
Program usage name	`harmonics_stop_time`
Evaluatable	Yes