Modelica.Electrical.Machines.Utilities

Library with auxiliary models for testing

Information

This package contains utility components for testing examples.

Extends from Modelica.Icons.UtilitiesPackage (Icon for utility packages).

Package Content

Name	Description
ParameterRecords	Parameter records
VfController	Voltage-Frequency-Controller
CurrentController	Current controller
VoltageController	Current controller
ToDQ
FromDQ
SwitchYD	Y-D-switch
TerminalBox	Terminal box Y/D-connection
SwitchedRheostat	Rheostat which is shortened after a given time
RampedRheostat	Rheostat with linearly decreasing resistance
SynchronousMachineData	Computes machine parameter from usual datasheet
TransformerData	Calculates Impedances from nominal values

Modelica.Electrical.Machines.Utilities.VfController

Voltage-Frequency-Controller

Information

Simple Voltage-Frequency-Controller.
Amplitude of voltage is linear dependent (VNominal/fNominal) on frequency (input signal "u"), but limited by VNominal (nominal RMS voltage per phase).
m sine-waves with amplitudes as described above are provided as output signal "y".
The sine-waves are intended to feed a m-phase SignalVoltage.
Phase shifts between sine-waves may be chosen by the user; default values are (k-1)/m*pi for k in 1:m.

Extends from Modelica.Blocks.Interfaces.SIMO (Single Input Multiple Output continuous control block).

Parameters

Name Description

nout Number of outputs

m Number of phases

orientation[m] Orientation of phases [rad]

VNominal Nominal RMS voltage per phase [V]

fNominal Nominal frequency [Hz]

BasePhase Common phase shift [rad]

Name	Description
nout	Number of outputs
m	Number of phases
orientation[m]	Orientation of phases [rad]
VNominal	Nominal RMS voltage per phase [V]
fNominal	Nominal frequency [Hz]
BasePhase	Common phase shift [rad]

Connectors

Name Description

u Connector of Real input signal

y[nout] Connector of Real output signals

Name	Description
u	Connector of Real input signal
y[nout]	Connector of Real output signals

Modelica.Electrical.Machines.Utilities.CurrentController

Current controller

Information

Simple Current-Controller.

The desired rms values of d- and q-component of the space phasor current in rotor fixed coordinate system are given by inputs "id_rms" and "iq_rms". Using the given rotor position (input "phi"), the correct three-phase currents (output "i[3]") are calculated. They can be used to feed a current source which in turn feeds an induction machine.

Extends from Modelica.Blocks.Interfaces.MO (Multiple Output continuous control block).

Parameters

Name Description

p Number of pole pairs

nout Number of outputs

Name	Description
p	Number of pole pairs
nout	Number of outputs

Connectors

Name Description

y[nout] Connector of Real output signals

id_rms

iq_rms

phi

Name	Description
y[nout]	Connector of Real output signals
id_rms
iq_rms
phi

Modelica.Electrical.Machines.Utilities.VoltageController

Current controller

Information

Simple Voltage-Controller

The desired rms values of d- and q-component of the space phasor current in rotor fixed coordinate system are given by inputs "id_rms" and "iq_rms". Using the given rotor position (input "phi"), the actual threephase currents are measured and transformed to the d-q coordinate system. Two PI-controller determine the necessary d- and q- voltages, which are transformed back to threephase (output "y[3]"). They can be used to feed a voltage source which in turn feeds a permanent magnet synchronous machine.

Note: No care is taken for current or voltage limiting, as well as for field weakening.

Extends from Modelica.Blocks.Interfaces.MO (Multiple Output continuous control block).

Parameters

Name Description

p Number of pole pairs

fsNominal Nominal frequency [Hz]

VsOpenCircuit Open circuit RMS voltage per phase @ fsNominal [V]

Rs Stator resistance per phase at TOperational [Ohm]

Ld Inductance in d-axis [H]

Lq Inductance in q-axis [H]

decoupling Use decoupling network

nout Number of outputs

Name	Description
p	Number of pole pairs
fsNominal	Nominal frequency [Hz]
VsOpenCircuit	Open circuit RMS voltage per phase @ fsNominal [V]
Rs	Stator resistance per phase at TOperational [Ohm]
Ld	Inductance in d-axis [H]
Lq	Inductance in q-axis [H]
decoupling	Use decoupling network
nout	Number of outputs

Connectors

Name Description

y[nout] Connector of Real output signals

id_rms

iq_rms

phi

iActual[3]

Name	Description
y[nout]	Connector of Real output signals
id_rms
iq_rms
phi
iActual[3]

Modelica.Electrical.Machines.Utilities.ToDQ

Information

Threepase values u[3] are transformed to the corresponding spacePhasor which is rotated to the rotor-fixed coordinate system, using the provided mechanical rotor angle phi. The ouput is the rsulting d- / q- components y[2].

Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).

Parameters

Name Description

p Number of pole pairs

Name	Description
p	Number of pole pairs

Connectors

Name Description

y[2] Connector of Real output signals

phi

u[3] Connector of Real input signals

Name	Description
y[2]	Connector of Real output signals
phi
u[3]	Connector of Real input signals

Modelica.Electrical.Machines.Utilities.FromDQ

Information

The d- / q- components u[2] are rotated back to the stator-fixed coordinate system, using the provided mechanical rotor angle phi. The output is the result of the back-transformation to threephase values y[3].

Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).

Parameters

Name Description

p Number of pole pairs

Name	Description
p	Number of pole pairs

Connectors

Name Description

y[3] Connector of Real output signals

phi

u[2] Connector of Real input signals

Name	Description
y[3]	Connector of Real output signals
phi
u[2]	Connector of Real input signals

Modelica.Electrical.Machines.Utilities.SwitchYD

Y-D-switch

Information

Simple Star-Delta-switch.
If control is false, plug_sp and plug_sn are star connected and plug_sp connected to the supply plug.
If control is true, plug_sp and plug_sn are delta connected and they are connected to the supply plug.

Parameters

Name Description

m Number of phases

Name	Description
m	Number of phases

Connectors

Name Description

plugSupply To grid

plug_sp To positive stator plug

plug_sn To negative stator plug

control[m]

Name	Description
plugSupply	To grid
plug_sp	To positive stator plug
plug_sn	To negative stator plug
control[m]

Modelica.Electrical.Machines.Utilities.TerminalBox

Terminal box Y/D-connection

Information

TerminalBox: at the bottom connected to both machine plugs, connect at the top to the grid as usual,
choosing Y-connection (StarDelta=Y) or D-connection (StarDelta=D).

Parameters

Name Description

m Number of phases

terminalConnection Choose Y=star/D=delta

Name	Description
m	Number of phases
terminalConnection	Choose Y=star/D=delta

Connectors

Name Description

plug_sp To positive stator plug

plug_sn To negative stator plug

plugSupply To grid

starpoint

Name	Description
plug_sp	To positive stator plug
plug_sn	To negative stator plug
plugSupply	To grid
starpoint

Modelica.Electrical.Machines.Utilities.SwitchedRheostat

Rheostat which is shortened after a given time

Information

Switched rheostat, used for starting asynchronous induction motors with slipring rotor:

The external rotor resistance RStart is shortened at time tStart.

Parameters

Name Description

m Number of phases

RStart Starting resistance [Ohm]

tStart Duration of switching on the starting resistor [s]

Name	Description
m	Number of phases
RStart	Starting resistance [Ohm]
tStart	Duration of switching on the starting resistor [s]

Connectors

Name Description

plug_p To positive rotor plug

plug_n To negative rotor plug

Name	Description
plug_p	To positive rotor plug
plug_n	To negative rotor plug

Modelica.Electrical.Machines.Utilities.RampedRheostat

Rheostat with linearly decreasing resistance

Information

Ramped rheostat, used for starting asynchronous induction motors with slipring rotor:

The external rotor resistance RStart is reduced to zero, starting at time tStart with a linear ramp tRamp.

Parameters

Name Description

m Number of phases

RStart Starting resistance [Ohm]

tStart Time instance of reducing the rheostat [s]

tRamp Duration of ramp [s]

Name	Description
m	Number of phases
RStart	Starting resistance [Ohm]
tStart	Time instance of reducing the rheostat [s]
tRamp	Duration of ramp [s]

Connectors

Name Description

plug_p To positive rotor plug

plug_n To negative rotor plug

Name	Description
plug_p	To positive rotor plug
plug_n	To negative rotor plug

Modelica.Electrical.Machines.Utilities.SynchronousMachineData

Computes machine parameter from usual datasheet

Information

The parameters of the synchronous machine model with electrical excitation (and damper) are calculated from parameters normally given in a technical description, according to the standard EN 60034-4:2008 Appendix C.

Extends from Modelica.Icons.Record (Icon for records).

Parameters

Name Description

SNominal Nominal apparent power [VA]

VsNominal Nominal stator voltage per phase [V]

fsNominal Nominal stator frequency [Hz]

IeOpenCircuit Open circuit excitation current @ nominal voltage and frequency [A]

x0 Stator stray inductance per phase (approximately zero impedance) [pu]

xd Synchronous reactance per phase, d-axis [pu]

xq Synchronous reactance per phase, q-axis [pu]

xdTransient Transient reactance per phase, d-axis [pu]

xdSubtransient Subtransient reactance per phase, d-axis [pu]

xqSubtransient Subtransient reactance per phase, q-axis [pu]

Ta Armature time constant [s]

Td0Transient Open circuit field time constant Td0' [s]

Td0Subtransient Open circuit subtransient time constant Td0'', d-axis [s]

Tq0Subtransient Open circuit subtransient time constant Tq0'', q-axis [s]

Material

TsSpecification Specification temperature of stator resistance [K]

TsRef Reference temperature of stator resistance [K]

alpha20s Temperature coefficient of stator resistance at 20 degC [1/K]

TrSpecification Specification temperature of (optional) damper cage [K]

TrRef Reference temperature of damper resistances in d- and q-axis [K]

alpha20r Temperature coefficient of damper resistances in d- and q-axis [1/K]

TeSpecification Specification excitation temperature [K]

TeRef Reference temperature of excitation resistance [K]

alpha20e Temperature coefficient of excitation resistance [1/K]

Result

Rs Stator resistance per phase at TRef [Ohm]

Lssigma Stator stray inductance per phase [H]

Lmd Main field inductance in d-axis [H]

Lmq Main field inductance in q-axis [H]

Lrsigmad Damper stray inductance in d-axis [H]

Lrsigmaq Damper stray inductance in q-axis [H]

Rrd Damper resistance in d-axis at TRef [Ohm]

Rrq Damper resistance in q-axis at TRef [Ohm]

Re Excitation resistance at TRef [Ohm]

sigmae Stray fraction of total excitation inductance

Name	Description
SNominal	Nominal apparent power [VA]
VsNominal	Nominal stator voltage per phase [V]
fsNominal	Nominal stator frequency [Hz]
IeOpenCircuit	Open circuit excitation current @ nominal voltage and frequency [A]
x0	Stator stray inductance per phase (approximately zero impedance) [pu]
xd	Synchronous reactance per phase, d-axis [pu]
xq	Synchronous reactance per phase, q-axis [pu]
xdTransient	Transient reactance per phase, d-axis [pu]
xdSubtransient	Subtransient reactance per phase, d-axis [pu]
xqSubtransient	Subtransient reactance per phase, q-axis [pu]
Ta	Armature time constant [s]
Td0Transient	Open circuit field time constant Td0' [s]
Td0Subtransient	Open circuit subtransient time constant Td0'', d-axis [s]
Tq0Subtransient	Open circuit subtransient time constant Tq0'', q-axis [s]
Material
TsSpecification	Specification temperature of stator resistance [K]
TsRef	Reference temperature of stator resistance [K]
alpha20s	Temperature coefficient of stator resistance at 20 degC [1/K]
TrSpecification	Specification temperature of (optional) damper cage [K]
TrRef	Reference temperature of damper resistances in d- and q-axis [K]
alpha20r	Temperature coefficient of damper resistances in d- and q-axis [1/K]
TeSpecification	Specification excitation temperature [K]
TeRef	Reference temperature of excitation resistance [K]
alpha20e	Temperature coefficient of excitation resistance [1/K]
Result
Rs	Stator resistance per phase at TRef [Ohm]
Lssigma	Stator stray inductance per phase [H]
Lmd	Main field inductance in d-axis [H]
Lmq	Main field inductance in q-axis [H]
Lrsigmad	Damper stray inductance in d-axis [H]
Lrsigmaq	Damper stray inductance in q-axis [H]
Rrd	Damper resistance in d-axis at TRef [Ohm]
Rrq	Damper resistance in q-axis at TRef [Ohm]
Re	Excitation resistance at TRef [Ohm]
sigmae	Stray fraction of total excitation inductance

Modelica.Electrical.Machines.Utilities.TransformerData

Calculates Impedances from nominal values

Information

The parameters of the transformer models are calculated from parameters normally given in a technical description.

Extends from Modelica.Icons.Record (Icon for records).

Parameters

Name Description

f Nominal frequency [Hz]

V1 Primary nominal line-to-line voltage (RMS) [V]

C1 Choose primary connection

V2 Secondary open circuit line-to-line voltage (RMS) @ primary nominal voltage [V]

C2 Choose secondary connection

SNominal Nominal apparent power [VA]

v_sc Impedance voltage drop pu

P_sc Short-circuit (copper) losses [W]

Result

n Ratio primary voltage (line-to-line) / secondary voltage (line-to-line)

R1 Warm primary resistance per phase [Ohm]

L1sigma Primary stray inductance per phase [H]

R2 Warm secondary resistance per phase [Ohm]

L2sigma Secondary stray inductance per phase [H]

Name	Description
f	Nominal frequency [Hz]
V1	Primary nominal line-to-line voltage (RMS) [V]
C1	Choose primary connection
V2	Secondary open circuit line-to-line voltage (RMS) @ primary nominal voltage [V]
C2	Choose secondary connection
SNominal	Nominal apparent power [VA]
v_sc	Impedance voltage drop pu
P_sc	Short-circuit (copper) losses [W]
Result
n	Ratio primary voltage (line-to-line) / secondary voltage (line-to-line)
R1	Warm primary resistance per phase [Ohm]
L1sigma	Primary stray inductance per phase [H]
R2	Warm secondary resistance per phase [Ohm]
L2sigma	Secondary stray inductance per phase [H]

Automatically generated Mon Sep 23 17:20:32 2013.