Engee documentation

Wye-Connected Load

A three-phase load connected according to the Star scheme.

blockType: AcausalElectricPowerSystems.Passive.RLC_Assemblies.WyeConnectedLoad

Path in the library:

/Physical Modeling/Electrical/Passive/RLC Assemblies/Wye-Connected Load

Description

Block Wye-Connected Load simulates a three-phase load connected according to the Star scheme. Each phase of the load can include any combination of resistor , of the capacitor and the inductors , connected in series or in parallel. The load is phase-symmetric, that is, the values of resistance, capacitance and inductance of all phases are the same.

Component values , and They can be set either directly as resistance, inductance, and capacitance, or through the values of rated powers (i.e., at rated voltage and frequency).

  • If the block is parameterized directly through the values , and , then a three-element vector is set for initialization-a string of initial voltages for the capacitor and a three-element vector-a string of initial currents for the inductor.

  • If the unit is parameterized through the nominal power values, the initial voltage value, the initial voltage phase, and the initial frequency are set for initialization. For example, if the load is connected directly to a three-phase voltage source, the initial values should be equal to the RMS values of the line voltage, frequency, and phase of this source. To set the initial voltage to zero, set the initial voltage to 0.

Parameterization of the block

The following two tables list the block parameters for each component structure based on the selected parameterization option.

  • According to the rated power.

    The structure of the components Basic parameters Parameters of the initial conditions

    R

    Rated voltage

    Active power

    No

    L

    Rated voltage

    Rated frequency

    Inductive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    C

    Rated voltage

    Rated frequency

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Series RL

    Rated voltage

    Rated frequency

    Active power

    Inductive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Series RC

    Rated voltage

    Rated frequency

    Active power

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Series LC

    Rated voltage

    Rated frequency

    Inductive reactive power

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Series RLC

    Rated voltage

    Rated frequency

    Active power

    Inductive reactive power

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Parallel RL

    Rated voltage

    Rated frequency

    Active power

    Inductive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Parallel RC

    Rated voltage

    Rated frequency

    Active power

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Parallel LC

    Rated voltage

    Rated frequency

    Inductive reactive power

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

    Parallel RLC

    Rated voltage

    Rated frequency

    Active power

    Inductive reactive power

    Capacitive reactive power

    The amount of voltage at the terminals

    Terminal voltage phase

    Frequency

  • The values of the components directly.

    The structure of the components Basic parameters Parameters of the initial conditions

    R

    Resistance

    No

    L

    Inductance

    The initial current of the inductor [Ia Ib Ic]

    C

    Container

    Initial voltage of the capacitor [Va Vb Vc]

    Series RL

    Resistance

    Inductance

    The initial current of the inductor [Ia Ib Ic]

    Series RC

    Resistance

    Container

    Initial voltage of the capacitor [Va Vb Vc]

    Series LC

    Inductance

    Container

    The initial current of the inductor [Ia Ib Ic]

    Initial voltage of the capacitor [Va Vb Vc]

    Series RLC

    Resistance

    Inductance

    Container

    The initial current of the inductor [Ia Ib Ic]

    Initial capacitor voltage [Va Vb Vc]

    Parallel RL

    Resistance

    Inductance

    The initial current of the inductor [Ia Ib Ic]

    Parallel RC

    Resistance

    Container

    Initial voltage of the capacitor [Va Vb Vc]

    Parallel LC

    Inductance

    Container

    The initial current of the inductor [Ia Ib Ic]

    Initial voltage of the capacitor [Va Vb Vc]

    Parallel RLC

    Resistance

    Inductance

    Container

    The initial current of the inductor [Ia Ib Ic]

    Initial voltage of the capacitor [Va Vb Vc]

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

# ~ — three-phase port
electricity

Details

Three-phase electrical port for connecting the load to the network.

Program usage name

port

# n — neutral
electricity

Details

The electrical port corresponds to the neutral point of the star.

Program usage name

n

Parameters

Main

# Parameterization — parameterization
Specify component values directly | Specify by rated power

Details

Parameterization of the block:

  • Specify by rated power — values for components , and They are set using the values of rated power at rated voltage and frequency.

  • Specify component values directly — values for components , and They are set directly as resistance, inductance, and capacitance.

Switching the parameter value Parameterization resets the parameter value Component structure. First, select the parameter value Parameterization and then Component structure. If you switch the parameter value later Parameterization, check the parameter value Component structure and select it again, if necessary.

Values

Specify component values directly | Specify by rated power

Default value

Specify by rated power

Program usage name

parameterization

Evaluatable

No

# Component structure — combination , and
R | L | C | Series RL | Series RC | Series LC | Series RLC | Parallel RL | Parallel RC | Parallel LC | Parallel RLC

Details

Sets the resistor combination ( ), the capacitor ( ) and inductors ( ), connected in series or in parallel.

Values

R | L | C | Series RL | Series RC | Series LC | Series RLC | Parallel RL | Parallel RC | Parallel LC | Parallel RLC

Default value

R

Program usage names

component_structure, component_structure_PQ

Evaluatable

No

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

Details

The resistance of each resistor.

Dependencies

This parameter is used only when selecting a value. Specify component values directly the parameter Parameterization and choosing the structure of the component that includes the resistor.

Units

Ohm | mOhm | kOhm | MOhm | GOhm

Default value

1.0 Ohm

Program usage name

R

Evaluatable

Yes

# Inductance — inductance
H | nH | uH | mH

Details

The inductance of each coil.

Dependencies

This parameter is used only when selecting a value. Specify component values directly the parameter Parameterization and the choice of the component structure, including the inductor.

Units

H | nH | uH | mH

Default value

1e-3 H

Program usage name

L

Evaluatable

Yes

# Capacitance — container
F | pF | nF | uF | mF

Details

The capacity of each capacitor.

Dependencies

This parameter is used only when selecting a value. Specify component values directly the parameter Parameterization and the choice of the component structure, including the capacitor.

Units

F | pF | nF | uF | mF

Default value

1e-06 F

Program usage name

C

Evaluatable

Yes

# Rated voltage — Rated voltage
V | uV | mV | kV | MV

Details

The voltage for which the load capacities are specified.

Dependencies

This parameter is used only when selecting a value. Specify by rated power the parameter Parameterization.

Units

V | uV | mV | kV | MV

Default value

24e3 V

Program usage name

V_rated

Evaluatable

Yes

# Rated electrical frequency — Rated frequency
Hz | kHz | MHz | GHz

Details

The frequency for which the reactive power of the load is specified.

Dependencies

This parameter is used only when selecting a value. Specify by rated power the parameter Parameterization.

Units

Hz | kHz | MHz | GHz

Default value

50 Hz

Program usage name

f_rated

Evaluatable

Yes

# Real power — total active power dissipation
W | uW | mW | kW | MW | GW | V*A | HP_DIN

Details

The total active power dissipated by a three-phase load at rated voltage. The value must be higher 0.

Dependencies

This parameter is used only when selecting a value. Specify by rated power the parameter Parameterization and choosing the structure of the component that includes the resistor.

Units

W | uW | mW | kW | MW | GW | V*A | HP_DIN

Default value

1e3 W

Program usage name

P

Evaluatable

Yes

# Inductive reactive power — inductive reactive power
W | uW | mW | kW | MW | GW | V*A | HP_DIN

Details

The total inductive reactive power consumed by a three-phase load at rated voltage. The value must be greater than 0.

Dependencies

This parameter is used only when selecting a value. Specify by rated power the parameter Parameterization and the choice of the component structure, including the inductor.

Units

W | uW | mW | kW | MW | GW | V*A | HP_DIN

Default value

1e2 V*A

Program usage name

Q_l

Evaluatable

Yes

# Capacitive reactive power — total capacitive reactive power
W | uW | mW | kW | MW | GW | V*A | HP_DIN

Details

The total capacitive reactive power consumed by a three-phase load at rated voltage. The value should be less than 0.

Dependencies

This parameter is used only when selecting a value. Specify by rated power the parameter Parameterization and the choice of the component structure, including the capacitor.

Units

W | uW | mW | kW | MW | GW | V*A | HP_DIN

Default value

-1e2 V*A

Program usage name

Q_c

Evaluatable

Yes

Parasitics

# Parasitic series resistance — parasitic sequential resistance
Ohm | mOhm | kOhm | MOhm | GOhm

Details

It represents small parasitic effects. The value of the parameter corresponds to the value of the series resistance added to all instances of capacitors in the load.

Units

Ohm | mOhm | kOhm | MOhm | GOhm

Default value

0.0 Ohm

Program usage names

R_parasitic, R_parasitic_PQ

Evaluatable

Yes

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

Details

It represents small parasitic effects. The parameter value corresponds to the parallel conduction value added to all instances of inductors in the load.

If you set for the parameter Component structure one of the values is Series RL, Series LC or Series RLC The parasitic parallel conduction is connected through a complete block branch.

Units

S | nS | uS | mS | 1/Ohm

Default value

0.0 1/Ohm

Program usage names

G_parasitic, G_parasitic_PQ

Evaluatable

Yes

Initial Conditions

# Terminal voltage magnitude — the initial voltage amplitude at the terminals
V | uV | mV | kV | MV

Details

Dependencies

To use this parameter, set for the parameter Parameterization meaning Specify by rated power, and for the parameter Component structure any value other than R.

Units

V | uV | mV | kV | MV

Default value

24e3 V

Program usage name

V_mag_start

Evaluatable

Yes

# Terminal voltage angle — the initial phase of terminal voltage
rad | deg | rev | mrad | arcsec | arcmin | gon

Details

The initial phase of the terminal voltage.

Dependencies

To use this parameter, set for the parameter Parameterization meaning Specify by rated power, and for the parameter Component structure any value other than R.

Units

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

Default value

0 deg

Program usage name

V_ang_start

Evaluatable

Yes

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

Details

The frequency of the first simulation cycle.

Dependencies

To use this parameter, set for the parameter Parameterization meaning Specify by rated power, and for the parameter Component structure any value other than R.

Units

Hz | kHz | MHz | GHz

Default value

50 Hz

Program usage name

f_start

Evaluatable

Yes