Engee documentation

Voltage Source (Three-Phase)

An ideal three-phase voltage source with additional harmonics.

blockType: AcausalElectricPowerSystems.Sources.ThreePhaseVoltage

Path in the library:

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

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.

Ports

Conserving

# n — neutral
electricity

Details

The electrical port corresponds to the neutral point.

Program usage name

n

# ~ — three-phase port
electricity

Details

Three-phase port, corresponds to the phases , and the source.

Program usage name

port

Parameters

Main

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

Details

RMS linear (interphase) voltage.

Units

V | uV | mV | kV | MV

Default value

100*sqrt(3/2) V

Program usage name

v_line_rms

Evaluatable

Yes

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

Details

Phase shift.

Units

rad | deg | rev | mrad | arcsec | arcmin | gon

Default value

0 deg

Program usage name

shift

Evaluatable

Yes

# Frequency — current frequency
Hz | kHz | MHz | GHz

Details

Current frequency.

Units

Hz | kHz | MHz | GHz

Default value

50.0 Hz

Program usage name

f

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

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

Short circuit power.

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

# 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

Ohm | mOhm | kOhm | MOhm | GOhm

Default value

0.01 Ohm

Program usage name

R

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

H | nH | uH | mH

Default value

0.000397 H

Program usage name

L

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

false (switched off)

Program usage name

generate_harmonic

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

[5, 7, 11, 13]

Program usage name

harmonic_orders

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

[0.1, 0.1, 0.1, 0.1]

Program usage name

harmonic_ratios

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

S | nS | uS | mS | 1/Ohm

Default value

0 1/Ohm

Program usage name

G_parasitic

Evaluatable

Yes