Voltage Source (Three-Phase)
An ideal three-phase voltage source with additional harmonics.
blockType: AcausalElectricPowerSystems.Sources.ThreePhaseVoltage
Path in the library:
|
Description
Block Voltage Source (Three-Phase) simulates either an ideal three-phase voltage source or a three-phase voltage source with additional harmonics. The configuration is set by the parameter Generate harmonics.
If for the parameter Source impedance the value is set None, block Voltage Source (Three-Phase) simulates an ideal three-phase voltage source that maintains a sinusoidal voltage of a given magnitude at its terminals, regardless of the current flowing through it.
The source is connected by a star, the port n corresponds to the neutral. Port ~ is a three—phase port representing three phases: , and . The current is positive if it flows from neutral to phase, and the voltage on each phase is equal to the difference between the terminal voltage and the neutral voltage., .
The equations
The output voltage is determined by the following equations:
where
— amplitude phase voltage;
, , — appropriate phase voltages;
— frequency;
— phase shift;
— the time.
In the case of a three-phase voltage source with additional harmonics, the output voltage is determined by the following equations:
where
— a string vector containing the amplitude voltages of the fundamental and higher harmonics;
— RMS line voltage;
— vector is a string of harmonic coefficients. The first element is equal to 1, which corresponds to the fundamental harmonic;
— vector is a string of harmonic numbers. The first element is equal to 1, which corresponds to the fundamental harmonic;
, , — appropriate phase voltages;
— vector column of harmonic frequencies. The first element is the fundamental frequency;
— vector column of phase shifts of harmonics. The first element is the phase shift of the fundamental harmonic;
— vector column of harmonic phase shifts. The first element is 120°
— the time.
When selecting a value X/R Ratio for the parameter Source impedance the equations for the source impedance will be as follows:
where
— the specified short-circuit power level;
— the specified X/R source ratio;
— the calculated resistance of the source;
— the calculated reactance of the source;
— the calculated inductance of the source.
Variables
Use the parameter group 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.
Parameters
Main
#
Rated voltage (phase-to-phase RMS) —
RMS line voltage
V | uV | mV | kV | MV
Details
RMS linear (interphase) voltage.
| Units |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
#
Phase shift —
phase shift
rad | deg | rev | mrad | arcsec | arcmin | gon
Details
Phase shift.
| Units |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
#
Frequency —
current frequency
Hz | kHz | MHz | GHz
Details
Current frequency.
| Units |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
#
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 |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
No |
#
Short-circuit power level —
short circuit power
W | uW | mW | kW | MW | GW | V*A | HP_DIN
Details
Short circuit power.
Dependencies
To use this parameter, set for the parameter Source impedance meaning X/R Ratio.
| Units |
|
| Default value |
|
| Program usage name |
|
| 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 |
|
| Program usage name |
|
| Evaluatable |
Yes |
#
R —
source resistance
Ohm | mOhm | kOhm | MOhm | GOhm
Details
Ohmic resistance of the source.
Dependencies
To use this parameter, set for the parameter Source impedance values Series R or Series RL.
| Units |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
#
L —
source inductance
H | nH | uH | mH
Details
The inductance of the source.
Dependencies
To use this parameter, set for the parameter Source impedance values Series R or Series RL.
| Units |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
Harmonics
# Generate harmonics — generation of higher harmonics
Details
If this box is not checked, then there are no higher harmonics.
If this option is selected, the higher harmonics are added to the main harmonics.
| Default value |
|
| Program usage name |
|
| Evaluatable |
No |
# Harmonic orders — harmonic orders
Details
Vector is a string of orders of higher harmonics; positive integers.
Dependencies
To use this option, check the box Generate harmonics.
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
# Harmonic magnitude to peak magnitude ratios — the ratio of the amplitudes of the higher harmonics to the amplitude of the fundamental
Details
A vector is a string of ratios of the amplitudes of the higher harmonics to the amplitude of the fundamental.
Dependencies
To use this option, check the box Generate harmonics.
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |
Parasitics
#
Source impedance parasitic parallel conductance —
parasitic parallel conduction
S | nS | uS | mS | 1/Ohm
Details
Parasitic parallel conduction of the source impedance.
Dependencies
To use this parameter, set for the parameter Source impedance values Series R or Series RL.
| Units |
|
| Default value |
|
| Program usage name |
|
| Evaluatable |
Yes |