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
ToDQ	Transform instantaneous stator inputs to rotor fixed space phasor
FromDQ	Transform rotor fixed space phasor to instantaneous stator quantities
CurrentController	Current controller
VoltageController	Voltage controller
SwitchYD	Y-D-switch
TerminalBox	Terminal box Y/D-connection
MultiTerminalBox	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".
By setting parameter EconomyMode=true, Voltage rises quadratically with frequency which means flux,torque and loss reduction for fan and pump drives.
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]
EconomyMode	Economy mode: voltage quadratic dependent on frquency

Connectors

Name	Description
y[nout]	Connector of Real output signals

Modelica.Electrical.Machines.Utilities.ToDQ

Transform instantaneous stator inputs to rotor fixed space phasor

Information

The multi phase input values u[m] are transformed to the corresponding space phasor which is rotated to the rotor fixed reference system, using the provided mechanical rotor angle phi. The output are the resulting d and q components of the space phasor arranged in one vector y[2].

Parameters

Name	Description
nin	Number of inputs
nout	Number of outputs
m	Number of phases
p	Number of pole pairs

Connectors

Name	Description
u[nin]	Connector of Real input signals
y[nout]	Connector of Real output signals
phi	[rad]

Modelica.Electrical.Machines.Utilities.FromDQ

Transform rotor fixed space phasor to instantaneous stator quantities

Information

The d and q components of a space phasor u[2] are rotated back to the stator fixed reference system, using the provided mechanical rotor angle phi. The output are the instantaneous multi phase values y[m].

Parameters

Name	Description
nin	Number of inputs
nout	Number of outputs
m	Number of phases
p	Number of pole pairs

Connectors

Name	Description
u[nin]	Connector of Real input signals
y[nout]	Connector of Real output signals
phi	[rad]

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 "y[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
m	Number of phases
p	Number of pole pairs
nout	Number of outputs

Connectors

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

Modelica.Electrical.Machines.Utilities.VoltageController

Voltage 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 [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	[rad]
iActual[m]

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

Connectors

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

Connectors

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

Modelica.Electrical.Machines.Utilities.MultiTerminalBox

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

Connectors

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]

Connectors

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]

Connectors

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 [V.A]
VsNominal	Nominal stator voltage per phase [V]
fsNominal	Nominal stator frequency [Hz]
IeOpenCircuit	Open circuit excitation current @ nominal voltage and frequency [A]
effectiveStatorTurns	Effective number of stator turns
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 per phase in d-axis [H]
Lmq	Main field inductance per phase 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 [V.A]
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 Thu Dec 19 17:19:57 2019.

Modelica.Electrical.Machines.Utilities

Information

Package Content

Modelica.Electrical.Machines.Utilities.VfController

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.ToDQ

Information

See also

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.FromDQ

Information

See also

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.CurrentController

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.VoltageController

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.SwitchYD

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.TerminalBox

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.MultiTerminalBox

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.SwitchedRheostat

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.RampedRheostat

Information

Parameters

Connectors

Modelica.Electrical.Machines.Utilities.SynchronousMachineData

Information

Parameters

Modelica.Electrical.Machines.Utilities.TransformerData

Information

Parameters