Induction Machine Wound Rotor
Wound-rotor induction machine with per-unit or SI parameterization
Description
The Induction Machine Wound Rotor block models a wound-rotor
asynchronous machine with fundamental parameters expressed in per-unit or in the
International System of Units (SI). A wound-rotor asynchronous machine is a type of
induction machine. All stator and rotor connections are accessible on the block.
Therefore, you can model soft-start regimes using a switch between wye and delta
configurations or by increasing rotor resistance. If you do not need access to the rotor
windings, use the Induction Machine Squirrel Cage block
instead.
Connect port ~1 to a three-phase circuit. To connect the stator
in delta configuration, connect a Phase Permute block between ports
~1 and ~2. To connect the stator in wye
configuration, connect port ~2 to a Grounded Neutral
or a Floating Neutral block. If you do not need to vary rotor resistance,
connect rotor port ~1r' to a Floating Neutral block
and rotor port ~2r' to a Grounded Neutral
block.
The rotor circuit is referred to the stator. Therefore, when you use the block in a
circuit, refer any additional circuit parameters to the stator.
Equations
For the SI implementation, the block converts the SI values that you enter to
per-unit values for simulation. The converted values are based on the machine being
connected in a delta-winding configuration.
For the per-unit implementation, you must specify the resistances and inductances
in the impedances tab based on the machine being connected in a delta-winding
configuration.
For information on the relationship between SI and per-unit machine parameters,
see Per-Unit Conversion for Machine Parameters. For information on per-unit parameterization, see Per-Unit System of Units.
The asynchronous machine equations are expressed with respect to a synchronous
reference frame, defined by
where frated is the value of the
Rated electrical frequency parameter.
The Park transformation maps stator equations to a reference frame that is
stationary with respect to the rated electrical frequency. The Park transformation
is defined by
where θe is the
electrical angle.
The rotor equations are mapped to another reference frame, defined by the
difference between the electrical angle and the product of rotor angle
θr and number of pole pairs N:
The Park transformation is used to define the per-unit asynchronous machine
equations. The stator voltage equations are defined by
and
where:
vds,
vqs, and
v0s are the
d-axis, q-axis, and zero-sequence
stator voltages, defined by
va,
vb, and
vc are the stator voltages
across ports ~1 and ~2.
ωbase is the per-unit base
electrical speed.
ψds,
ψqs, and
ψ0s are the
d-axis, q-axis, and zero-sequence
stator flux linkages.
Rs is the stator
resistance.
ids,
iqs, and
i0s are the
d-axis, q-axis, and zero-sequence
stator currents, defined by
ia,
ib, and
ic are the stator currents
flowing from port ~1 to port
~2.
The rotor voltage equations are defined by
and
where:
vdr,
vqr, and
v0r are the
d-axis, q-axis, and zero-sequence
rotor voltages, defined by
var,
vbr, and
vcr are the rotor voltages
across ports ~1r' and ~2r'.
ψdr,
ψqr, and
ψ0r are the
d-axis, q-axis, and zero-sequence
rotor flux linkages.
ω is the per-unit synchronous speed. For a synchronous
reference frame, the value is 1.
ωr is the per-unit mechanical
rotational speed.
Rrd is the rotor resistance
referred to the stator.
idr,
iqr, and
i0r are the
d-axis, q-axis, and zero-sequence
rotor currents, defined by
iar,
ibr, and
icr are the rotor currents
flowing from port ~1r' to port
~2r'.
The stator flux linkage equations are defined by
and
where Lss is the stator self-inductance
and Lm is the magnetizing
inductance.
The rotor flux linkage equations are defined by
and
where Lrrd is the rotor self-inductance
referred to the stator.
The rotor torque is defined by
The stator self-inductance Lss, stator
leakage inductance Lls, and magnetizing
inductance Lm are related by
The rotor self-inductance Lrrd, rotor
leakage inductance Llrd, and magnetizing
inductance Lm are related by
When a saturation curve is provided, the equations to determine the saturated
magnetizing inductance as a function of magnetizing flux are:
For no saturation, the equation reduces to
Plotting and Display Options
You can perform plotting and display actions using the
menu on the block context menu.
Right-click the block and, from the menu,
select an option:
— Displays the machine
per-unit base values in the MATLAB® Command Window.
— Plots torque versus
speed, both measured in SI units, in a MATLAB figure window using the current machine parameters.
— Plots torque versus
speed, both measured in per-unit, in a MATLAB figure window using the current machine parameters.
— Plots terminal
voltage versus no-load line current, both in per-unit, in a MATLAB figure window. The plot contains three traces:
Unsaturated — Stator magnetizing inductance
(unsaturated).
Saturated — Open-circuit lookup table (v
versus i) you specify.
Derived — Open-circuit lookup table derived from the per-unit
open-circuit lookup table (v versus
i) you specify. This data is used to
calculate the saturated magnetizing inductance,
Lm_sat, and
the saturation factor,
Ks, versus
magnetic flux linkage,
ψm,
characteristics.
— Plots saturation
factor, Ks, versus magnetic flux
linkage, ψm, in a MATLAB figure window using the machine parameters. This parameter is
derived from other parameters that you specify:
No-load line current saturation data,
i
Terminal voltage saturation data, v
Leakage inductance,
Lls
— Plots magnetizing
inductance, Lm_sat, versus
magnetic flux linkage, ψm, in a
MATLAB figure window using the machine parameters. This parameter is
derived from other parameters that you specify:
No-load line current saturation data,
i
Terminal voltage saturation data, v
Leakage inductance,
Lls
For the SI implementation, v is in V (phase-phase RMS) and
i is in A (rms).
Variables
Use the Variables settings to specify the priority and initial target
values for the block variables before simulation. For more information, see Set Priority and Initial Target for Block Variables.
The type of
variables that are visible in the Variables settings depends on the
initialization method that you select, in the Main settings, for the
Initialization option parameter. To specify target values using:
Flux variables — Set the Initialization option parameter to
Set targets for flux variables
.
Data from a load-flow analysis — Set the Initialization
option parameter to Set targets for load flow
variables
.
If you select
Set targets for load flow variables
, to fully specify the initial
condition, you must include an initialization constraint in the form of a high-priority target
value. For example, if your induction machine is connected to an Inertia block, the initial condition for the induction machine is
completely specified if, in the Variables settings of the Inertia block, the Priority for Rotational
velocity is set to High
. Alternatively, you could set
the Priority to None
for the Inertia block Rotational velocity, and instead set the
Priority for the induction machine block Slip,
Real power generated, or Mechanical power consumed
to High
.
Ports
Output
expand all
pu
— Per-unit measurements output port
physical
Physical signal vector port associated with the machine per-unit
measurements. The vector elements are:
pu_torque
pu_velocity
pu_vds
pu_vqs
pu_v0s
pu_ids
pu_iqs
pu_i0s
Conserving
expand all
R
— Machine rotor
mechanical
Mechanical rotational conserving port associated with the machine
rotor.
C
— Machine case
mechanical
Mechanical rotational conserving port associated with the machine
case.
~1
— Stator positive-end connections
electrical
Expandable three-phase
port associated with the stator positive-end
connections.
~2
— Stator negative-end connections
electrical
Expandable three-phase
port associated with the stator negative-end
connections.
~1r'
— Rotor positive-end connections
electrical
Expandable three-phase
port associated with the rotor positive-end
connections.
~2r'
— Rotor negative-end connections
electrical
Expandable three-phase
port associated with the rotor negative-end
connections.
Parameters
expand all
All default parameter values are based on a machine delta-winding
configuration.
Main
Rated apparent power
— Rated apparent power
15e3
V*A
(default)
Rated apparent power of the induction machine.
Rated voltage
— RMS voltage
220
V
(default)
Rated electrical frequency
— Nominal electrical frequency
60
Hz
(default)
Nominal electrical frequency corresponding to the rated apparent
power.
Number of pole pairs
— Machine pole pairs
1
(default)
Number of machine pole pairs.
Parameterization unit
— Unit system for block parameterization
SI
(default) | Per unit
Unit system for block parameterization. Choose between
SI
, the international system of units,
and Per unit
, the per-unit system.
Dependencies
Selecting:
Zero sequence
— Zero sequence
Include
(default) | Exclude
Zero-sequence model:
Include
— Prioritize model
fidelity. An error occurs if you Include zero-sequence terms
for simulations that use the Partitioning solver. For more
information, see Increase Simulation Speed Using the Partitioning Solver.
Exclude
— Prioritize simulation
speed for desktop simulation or real-time deployment.
Dependencies
If this parameter is set to:
Include
and
Parameterization unit is set to
SI
— The Stator
zero-sequence reactance, X0 parameter in
the Impedances settings is
visible.
Include
and
Parameterization unit is set to
Per unit
— The
Stator zero-sequence inductance, L0
(pu) parameter in the
Impedances settings is
visible.
Exclude
— The stator
zero-sequence parameter in the
Impedances settings is not
visible.
Initialization option
— Initialization method
Set targets for flux variables
(default) | Set targets for load flow variables
Initialization method. You can initialize a machine for steady-state simulation using
either flux data or data from a load-flow analysis.
If you select
Set targets for load flow variables
, to fully specify the initial
condition, you must include an initialization constraint in the form of a high-priority target
value. For example, if your induction machine is connected to an Inertia block, the initial condition for the induction machine is
completely specified if, in the Variables settings of the Inertia block, the Priority for Rotational
velocity is set to High
. Alternatively, you could set
the Priority to None
for the Inertia block Rotational velocity, and instead set the
Priority for the induction machine block Slip,
Real power generated, or Mechanical power consumed
to High
.
Dependencies
The type of
variables that are visible in the Variables settings depends on the
initialization method that you select, in the Main settings, for the
Initialization option parameter. To specify target values using:
Flux variables — Set the Initialization option parameter to
Set targets for flux variables
.
Data from a load-flow analysis — Set the Initialization
option parameter to Set targets for load flow
variables
.
Impedances
For the Parameterization unit parameter in the
Main settings, select SI
to
expose SI parameters or Per unit
to expose per-unit
parameters.
Stator resistance, Rs
— Stator resistance
0.25
Ohm
(default)
Stator resistance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to
SI
.
Stator leakage reactance, Xls
— Stator leakage reactance
0.4
Ohm
(default)
Stator leakage reactance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to
SI
.
Referred rotor resistance, Rr'
— Referred rotor resistance
0.14
Ohm
(default)
Rotor resistance referred to the stator.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to
SI
.
Referred rotor leakage reactance, Xlr'
— Referred rotor leakage reactance
0.41
Ohm
(default)
Rotor leakage reactance referred to the stator.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to
SI
.
Magnetizing reactance, Xm
— Magnetizing reactance
17
Ohm
(default)
Magnetizing reactance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to
SI
.
Stator zero-sequence reactance, X0
— Stator zero-sequence reactance
0.4
Ohm
(default)
Stator zero-sequence reactance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to
SI
.
Stator resistance, Rs (pu)
— Per-unit stator resistance
0.0258
(default)
Per-unit stator resistance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to Per
unit
.
Stator leakage inductance, Lls (pu)
— Per-unit stator leakage inductance
0.0413
(default)
Per-unit stator leakage inductance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to Per
unit
.
Referred rotor resistance, Rr' (pu)
— Per-unit referred rotor resistance
0.0145
(default)
Per-unit rotor resistance referred to the stator.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to Per
unit
.
Referred rotor leakage inductance, Llr' (pu)
— Per-unit referred rotor leakage inductance
0.0424
(default)
Per-unit rotor leakage inductance referred to the stator.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to Per
unit
.
Magnetizing inductance, Lm (pu)
— Per-unit magnetizing inductance
1.7562
(default)
Per-unit magnetizing inductance, that is, the peak value of
stator-rotor mutual inductance.
Dependencies
This parameter is visible only if you set the
Parameterization unit parameter in the
Main setting to Per
unit
.
Stator zero-sequence inductance, L0 (pu)
— Per-unit stator zero-sequence inductance
0.0413
(default)
Per-unit stator zero-sequence inductance.
Dependencies
This parameter is visible only if, in the
Main settings, the
Parameterization unit parameter is set to
Per unit
and the Zero
sequence parameter is set to
Include
.
Saturation
For the Parameterization unit parameter in the Main
settings, select SI
to expose SI parameters or Per
unit
to expose per-unit parameters.
The saturation characteristic is based on the machine being connected in a delta-winding
configuration.
Magnetic saturation representation
— Magnetic saturation representation
None
(default) | Open-circuit lookup table (v versus i)
Block magnetic saturation representation.
Dependencies
If this parameter is set to Open-circuit lookup table (v
versus i)
, related parameters are visible.
No-load line current saturation data, i (rms)
— No-load line RMS current saturation data
[0, 4, 9, 18, 25, 34, 50, 68, 95, 120]
A
(default)
Current i data populates the voltage v
versus field current i lookup table. This parameter must
contain a vector with at least 10 elements.
Dependencies
This parameter is visible only if the Magnetic saturation
representation parameter is set to Open-circuit
lookup table (v versus i)
and, in the
Main settings, the Parameterization
unit parameter is set to
SI
.
Terminal voltage saturation data, v (phase-phase, rms)
— Terminal RMS voltage saturation data
[0, 88, 154, 198, 220, 242, 264, 286, 308,
327]
V
(default)
Terminal voltage v data populates the voltage
v versus current i lookup table. This
parameter must contain a vector with at least 10 elements. The number of
elements must match the number of elements in the vector for the
No-load line current saturation data, i (rms)
parameter.
Dependencies
This parameter is visible only if the Magnetic saturation
representation parameter is set to Open-circuit
lookup table (v versus i)
and, in the
Main settings, the Parameterization
unit parameter is set to
SI
.
Per-unit no-load line current saturation data, i
— Per-unit no-load line current saturation data
[0, .176, .396, .792, 1.1, 1.496, 2.2, 2.992, 4.18,
5.28]
(default)
Current i data populates the voltage v
versus field current i lookup table. This parameter must
contain a vector with at least 10 elements.
Dependencies
This parameter is visible only if the Magnetic saturation
representation parameter is set to Open-circuit
lookup table (v versus i)
and, in the
Main settings, the Parameterization
unit parameter is set to Per
unit
.
Per-unit terminal voltage saturation data, v
— Per-unit terminal voltage saturation data
[0, .4, .7, .9, 1, 1.1, 1.2, 1.3, 1.4,
1.4864]
(default)
Terminal voltage v data populates the voltage
v versus current i lookup table. This
parameter must contain a vector with at least 10 elements. The number of
elements must match the number of elements in the vector for the
Per-unit no-load line current saturation data, i
parameter.
Dependencies
This parameter is visible only if the Magnetic saturation
representation parameter is set to Open-circuit
lookup table (v versus i)
and, in the
Main settings, the Parameterization
unit parameter is set to Per
unit
.
Compatibility Considerations
expand all
Saturation characteristic update
Behavior changed in R2020a
From R2020a forward, for the saturation characteristic, the
Induction Machine Wound Rotor block takes into
account the magnetic flux due to the leakage inductance.
The default values for these parameters have changed:
Stator leakage reactance, Xls
Stator zero-sequence reactance, X0
Stator leakage inductance, Lls (pu)
Stator zero-sequence inductance, L0 (pu)
Terminal voltage saturation data, v (phase-phase,
rms)
Per-unit terminal voltage saturation data,
v
As a result of these changes, inside a model saved in an earlier release, if you
have used the Induction Machine Wound Rotor block
with saturation enabled, review the saturation data.
References
[1] Kundur, P. Power
System Stability and Control. New York, NY: McGraw Hill,
1993.
[2] Lyshevski, S. E.
Electromechanical Systems, Electric Machines and Applied
Mechatronics. Boca Raton, FL: CRC Press, 1999.
[3] Ojo, J. O., Consoli, A.,and
Lipo, T. A., "An improved model of saturated induction machines", IEEE Transactions on Industry Applications.
Vol. 26, no. 2, pp. 212-221, 1990.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
See Also
Simscape Blocks
Blocks
Introduced in R2013b