Three Phase Squirrel Cage Induction Machine
Description of the Three Phase Squirrel Cage Induction Machine component in Schematic Editor.
A, B, and C are stator winding terminals. The stator winding uses the current source interface.
Electrical sub-system model
The electrical part of the machine is represented by the following system of equations, modeled in the stationary αβ reference frame. All rotor variables and parameters are referred to the stator.
If the saturation effects are considered, the equations have the same form, but in that case the magnetizing flux is a function of the magnetizing current:
where:
If the Iron losses are enabled the electrical system equations will be modeled by a different system of equations which is described in Iron losses.
| Symbol | Description |
|---|---|
| ψαs | Alpha axis component of the stator flux [Wb] |
| ψβs | Beta axis component of the stator flux [Wb] |
| ψαr | Alpha axis component of the rotor flux, referred to the stator [Wb] |
| ψβr | Beta axis component of the rotor flux, referred to the stator [Wb] |
| iαs | Alpha axis component of the stator current [A] |
| iβs | Beta axis component of the stator current [A] |
| iαr | Alpha axis component of the rotor current, referred to the stator [A] |
| iβr | Beta axis component of the rotor current, referred to the stator [A] |
| vαs | Alpha axis component of the stator voltage [V] |
| vβs | Beta axis component of the stator voltage [V] |
| vαr | Alpha axis component of the rotor voltage, referred to the stator [V] |
| vβr | Beta axis component of the rotor voltage, referred to the stator [V] |
| Rs | Stator phase resistance [Ω] |
| Rr | Rotor phase resistance, referred to the stator [Ω] |
| Lm | Magnetizing (mutual, main) inductance [H] |
| Ls | Stator phase inductance [H] ( ) |
| Lr | Rotor phase inductance, referred to the stator [H] ( ) |
| ωr | Rotor electrical speed [rad/s] ( ) |
| p | Machine number of pole pairs |
| Te | Machine developed electromagnetic torque [Nm] |
| ψm | Magnetizing flux [Wb] |
| im | Magnetizing current [A] |
Mechanical sub-system model
Motion equation:
| Symbol | Description |
|---|---|
| ωm | Rotor mechanical speed [rad/s] |
| Jm | Combined rotor and load moment of inertia [kgm2] |
| Te | Machine developed electromagnetic torque [Nm] |
| Tl | Shaft mechanical load torque [Nm] |
| b | Machine viscous friction coefficient [Nms] |
| θm | Rotor mechanical angle [rad] |
Iron losses
The Three Phase Squirrel Cage Induction Machine component can include iron losses and high-frequency losses. Losses options are available only for the linear model type. They are enabled by checking the Iron losses checkbox. Core iron losses are modeled as a resistor (Rfe) in parallel with the magnetizing inductance. Additionally, it is possible to enable losses which occur due to the high frequency harmonics by checking the HF losses checkbox and setting the value of Rhf. High-frequency losses are modeled as a resistor in parallel with the stator leakage inductance.
When the iron losses are enabled, the magnetizing flux becomes an additional state variable and the electrical part of the machine is represented by the following system of equations, modeled in the stationary αβ reference frame. The stator and rotor voltage equations are the same as in Electrical sub-system model:
The flux linkages are determined by the currents through the stator leakage, rotor leakage and magnetizing inductances:
The current through the HF losses resistance is determined by the voltage across the stator leakage inductance, and the current through the iron losses resistance by the voltage across the magnetizing inductance:
The stator current flows through the parallel connection of the stator leakage inductance and the HF losses resistance, and the stator and rotor currents split between the magnetizing inductance and the iron losses resistance:
If the HF losses are disabled, iαhf = iβhf = 0. The electromagnetic torque is calculated from the magnetizing flux and the rotor current:
By selecting the Dynamic Rfe checkbox the Rfe field will become disabled and a signal processing input port will be created. This allows for changing the value of the losses resistance during the simulation.
| Symbol | Description |
|---|---|
| ψαm | Alpha axis component of the magnetizing flux [Wb] |
| ψβm | Beta axis component of the magnetizing flux [Wb] |
| iαls | Alpha axis component of the current through the stator leakage inductance [A] |
| iβls | Beta axis component of the current through the stator leakage inductance [A] |
| iαm | Alpha axis component of the current through the magnetizing inductance [A] |
| iβm | Beta axis component of the current through the magnetizing inductance [A] |
| iαfe | Alpha axis component of the current through the iron losses resistance [A] |
| iβfe | Beta axis component of the current through the iron losses resistance [A] |
| iαhf | Alpha axis component of the current through the HF losses resistance [A] |
| iβhf | Beta axis component of the current through the HF losses resistance [A] |
| Lls | Stator leakage inductance [H] |
| Llr | Rotor leakage inductance, referred to the stator [H] |
| Rfe | Iron losses resistance [Ω] |
| Rhf | High-frequency losses resistance [Ω] |
Saturation effects
The three phase squirrel cage induction machine component can include magnetic saturation effects. In that case, magnetizing flux or magnetizing inductance is defined as a function of the magnetizing current. That function is represented in the form of lookup table. The lookup tables use linear interpolation and linear extrapolation.
- magnetizing flux vs magnetizing current
- magnetizing inductance vs magnetizing current

im_vector = [0.0, 0.661428, 0.957988, 1.224002, 1.527775, 1.836498, 2.485056, 3.197537, 4.162313, 5.57879, 8.211348, 12.342407, 22.172606]
psim_vector = [0.0, 0.125279, 0.192308, 0.25488, 0.318532, 0.382499, 0.511695, 0.635623, 0.76725, 0.885866, 1.007544, 1.097936, 1.186302]
im_vector = [0.0, 0.661428, 0.957988, 1.224002, 1.527775, 1.836498, 2.485056, 3.197537, 4.162313, 5.57879, 8.211348, 12.342407, 22.172606]
Lm_vector = [0.0, 0.189407, 0.200741, 0.208235, 0.208494, 0.208277, 0.205909, 0.198785, 0.184332, 0.158792, 0.122701, 0.088956, 0.053503]Ports
- A (electrical)
- Stator winding phase A port.
- B (electrical)
- Stator winding phase B port.
- C (electrical)
- Stator winding phase C port.
- in
- Available if Model Load source is selected or Dynamic resistances, Fault simulation or Dynamic Rfe is enabled
- Input vector description and order:
- If Model Load source is selected:
- in[0] = model_load
- in[1] = Stator phase resistance [Ω], in[2] = Rotor phase resistance, referred to the stator [Ω] - if Dynamic resistances is enabled
- in[1] = Fault severity, in[2] = Rf [Ω] - if Fault simulation is enabled
- in[1] = Rfe [Ω] - if Dynamic Rfe is enabled
- in[1] = Stator phase resistance [Ω], in[2] = Rotor phase resistance, referred to the stator [Ω], in[3] = Rfe [Ω] - if Dynamic resistances and Dynamic Rfe are enabled
- If SCADA / external Load source is selected:
- in[0] = Stator phase resistance [Ω], in[1] = Rotor phase resistance, referred to the stator [Ω] - if Dynamic resistances is enabled
- in[0] = Fault severity, in[1] = Rf [Ω] - if Fault simulation is enabled
- in[0] = Rfe [Ω] - if Dynamic Rfe is enabled
- in[0] = Stator phase resistance [Ω], in[1] = Rotor phase resistance, referred to the stator [Ω], in[2] = Rfe [Ω] - if Dynamic resistances and Dynamic Rfe are enabled
- If Model Load source is selected:
- Fault simulation can't be enabled together with Dynamic resistances or Iron losses.
Electrical (Tab)
- Model Type
- Specifies machine model implementation.
- Two levels of model fidelity are available - linear and nonlinear.
- Magnetizing curve type
- Available if Model Type is set to nonlinear.
- Following saturation types can be specified - flux vs current and absolute inductance vs current.
- Rs
- Stator phase resistance [Ω]
- Rr
- Rotor phase resistance, referred to the stator [Ω]
- Lls
- Stator leakage inductance [H]
- Llr
- Rotor leakage inductance, referred to the stator [H]
- Lm
- Available if Model Type is set to linear
- Magnetizing (mutual) inductance of the motor, referred to the stator [H]
- Dynamic resistances
- Enables real-time change to stator and rotor resistances. If calculations of these resistances depend on the temperature, they can be routed to a load input with signal processing connections, provided that this property is enabled. The vectorized array [Rs, Rr] is in ohms.
- When enabled, a machine input terminal is either created or extended by a new input for defining this resistance value in ohms. More information can be found in the dedicated ports section.
-
Note: This property is only available if Fault Simulation is disabled.
-
A brief demonstration of how to enable Dynamic resistances is shown below (requires internet connection):
- Iron losses
- Available if Model Type is set to linear
- Enables calculation of iron losses
-
Note: This property is only available if Fault Simulation is disabled.
- Rfe
- Available if Iron losses is enabled
- Iron losses resistance [Ω]
- Dynamic Rfe
- Available if Iron losses are enabled
- Enables real-time change of iron losses resistance. If this resistance depends on some external parameters it can be calculated and routed to a load input with signal processing connections. Value of the resistance is in ohms.
- When enabled, a machine input terminal is either created or extended by a new input for defining this resistance value in ohms. More information can be found in the dedicated ports section.
- HF losses
- Available if Iron losses are enabled
- Enables calculation of high-frequency losses
- Rhf
- Available if Iron losses and HF losses are enabled
- High-frequency losses resistance [Ω]
- im vector
- Available if Model Type is set to nonlinear
- List of instantaneous values of the magnetizing current [A]
- psim vector
- Available if Model Type is set to nonlinear - flux vs current.
- List of instantaneous values of the magnetizing flux [Wb]
- Lm vector
- Available if Model Type is set to nonlinear - absolute inductance vs current.
- List of instantaneous values of the magnetizing inductance [Wb]
Mechanical (Tab)
- pms
- Machine number of pole pairs
- Jm
- Combined rotor and load moment of inertia [kgm2]
- Friction coefficient
- Machine viscous friction coefficient [Nms]
- Unconstrained mechanical angle
- Limiting mechanical angle between 0 and 2π
Load (Tab)
- Load source
- Load source can be set from SCADA/external or from model (in model case, one signal processing input will appear).
- In TyphoonSim, if SCADA/external is chosen as Load source, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog output 1, it will appear on analog input 1.
- External/Model load type
- Load type: torque or speed
- Load ai pin
- Load ai pin for external torque/speed command.
- In real-time/VHIL simulation, Load ai pin represent HIL analog input address for external torque command.
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog output 1, it will appear on analog input 1.
- Available only if SCADA/external is set as Load source.
- Load ai offset
- Assigned offset value to the input signal representing external torque command.
- Available only if SCADA/external is set as Load source.
- Load ai gain
- Assigned gain value to the input signal representing external torque command.
- Available only if SCADA/external is set as Load source.
External load enables you to use an analog input signal from a HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog channel with the load_ai_pin address as an external torque/speed load, and to assign offset (V) and gain (Nm/V) to the input signal, according to the formula:
Feedback (Tab)
- Encoder ppr
- Incremental encoder number of pulses per revolution
- Encoder Z pulse length
- Z digital signal pulse length in periods. Can be Quarter length or Full period (default)
- Resolver pole pairs
- Resolver number of pole pairs
- Resolver carrier source
- Resolver carrier signal source selection (internal or external)
- Resolver carrier frequency
- Resolver carrier signal frequency (internal carrier) [Hz]
- Available only if the Resolver carrier source property is set to internal
- External resolver carrier source type
- External resolver carrier signal source type selection (single ended or differential)
- Available only if the Resolver carrier source property is set to external
- Resolver ai pin 1
- Resolver carrier input channel 1 address (external carrier)
- Available only if the Resolver carrier source property is set to external
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog output 1, it will appear on analog input 1.
- Resolver ai pin 2
- Resolver carrier input channel 2 address (external carrier)
- Available only if the Resolver carrier source property is set to external and External resolver carrier source type property is set to differential
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog output 1, it will appear on analog input 1.
- Resolver ai offset
- Resolver carrier input channel offset (external carrier)
- Available only if the Resolver carrier source property is set to external
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog output 1, it will appear on analog input 1.
- Resolver ai gain
- Resolver carrier input channel gain (external carrier)
- Available only if the Resolver carrier source property is set to external
- In TyphoonSim, analog signals are read from the internal virtual IO bus. Hence, if some signal is sent to analog output 1, it will appear on analog input 1.
- Absolute encoder protocol
- Standardized protocol providing the absolute machine encoder position.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- Singleturn bits
- Number of machine absolute encoder singleturn bits.
- Available only if Absolute encoder protocol is not None.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- Enable multiturn
- Enables multiturn absolute encoder support.
- Available only if Absolute encoder protocol is not None.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- Multiturn bits
- Number of machine absolute encoder multiturn bits.
- Available only if Enable multiturn is checked.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- EnDat/SSI/BiSS clock DI pin
- Clock digital input pin for the chosen absolute encoder protocol type.
- Available only if Absolute encoder protocol is not None.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- Clock DI logic
- Clock DI pin logic: active high/active low.
- Available only if Absolute encoder protocol is not None.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- EnDat data DI pin
- EnDat data digital input pin.
- Available only if Absolute encoder protocol is EnDat.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
- Data DI logic
- EnDat data DI pin logic: active high/active low.
- Available only if Absolute encoder protocol is EnDat.
Absolute encoder protocol is ignored in TyphoonSim. Changing its value will not affect TyphoonSim simulation at all.
If an external resolver carrier source is selected, the source signal type can be set as either single ended or differential. The single ended external resolver carrier source type enables use of an analog input signal from the HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog channel with the res_ai_pin_1 address as the external carrier source. Additionally, offset (V) and gain (V/V) values can be assigned to the input signal, according to the formula:
The differential external resolver carrier source type enables use of two analog input signals from the HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog channels with the res_ai_pin_1 and the res_ai_pin_2 addresses. Analog signals from these HIL/TyphoonSim (internal virtual IO bus in TyphoonSim) analog inputs are subtracted, and the resulting signal is used as the external differential carrier source. Additionally, offset (V) and gain (V/V) values can be assigned to the input signal (similarly to the single ended case), according to the formula:
The following expression must hold in order to properly generate the encoder signals:
| symbol | description |
|---|---|
| enc_ppr | Encoder number of pulses per revolution |
| fm | Rotor mechanical frequency [Hz] |
| Ts | Simulation time step [s] |
Snubber (Tab)
- Rsnb stator
- Stator snubber resistance value [Ω]
All machines with current source based circuit interfaces have the Snubber tab in the properties window where the value of snubber resistance can be set. Snubbers are necessary in the cases when an inverter or a contactor is directly connected to the machine terminals. This value can be set to infinite (inf), but it is not recommended when a machine is directly connected to the inverter since there will be a current source directly connected to an open switch. In this case, one of each switch pairs S1 and S2, S3 and S4, and S5 and S6 will be forced closed by the circuit solver in order to avoid the topological conflicts. On the other hand, with finite snubber values, there's always a path for the currents Ia and Ib, so all inverter switches can be open in this case. Circuit representations of this circuit without and with snubber resistors are shown in Figure 7 and Figure 8 respectively. Snubbers are connected across the current sources.
Output (Tab)
This block tab enables a single, vectorized signal output from the machine. The output vector contains selected machine mechanical and/or electrical variables in the same order as listed in this tab.
- Execution rate
- Signal processing output execution rate [s]
- Electrical torque
- Machine electrical torque [Nm]
- Mechanical speed
- Machine mechanical angular speed [rad/s]
- Mechanical angle
- Machine mechanical angle [rad]
- Stator alpha axis current
- Alpha axis component of the stator current [A]
- Stator beta axis current
- Beta axis component of the stator current [A]
- Rotor alpha axis current
- Alpha axis component of the rotor current, referred to the stator [A]
- Rotor beta axis current
- Beta axis component of the rotor current, referred to the stator [A]
- Stator alpha axis flux
- Alpha axis component of the stator flux [Wb]
- Stator beta axis flux
- Beta axis component of the stator flux [Wb]
- Rotor alpha axis flux
- Alpha axis component of the rotor flux, referred to the stator [Wb]
- Rotor beta axis flux
- Beta axis component of the rotor flux, referred to the stator [Wb]
Fault (Tab)
In this block tab, you can choose the fault simulation and specify the type of fault. The chosen fault can be in one of the phases. When choosing the fault, a machine input terminal is either created or extended by a new vectorized input for defining fault parameters. For the ITSC (Interturn Short Circuit) fault type, the vectorized array is [severity factor, Rf]. The machine component fault tab layout is shown here:
- Fault Simulation
- Enabling input for fault parameters
- Fault type
- Type of the fault to be simulated
- Only Interturn Short Circuit is available at the time
-
Fault location
- Phase in which the fault is simulated
- Execution rate
- Signal processing execution rate at which the model matrices are calculated [s]
A brief tutorial video on how to test for an ITSC fault is shown below (requires internet connection):
Electrical sub-system model for a machine with an ITSC fault in phase A
| symbol | description |
|---|---|
| vαs | Alpha axis component of the stator voltage [V] |
| vβs | Beta axis component of the stator voltage [V] |
| vαs2 | Voltage of the short circuited turns in the phase a [V] |
| iαs | Alpha axis component of the stator current [A] |
| iβs | Beta axis component of the stator current [A] |
| iαr | Alpha axis component of the rotor current, referred to the stator [A] |
| iβr | Beta axis component of the rotor current, referred to the stator [A] |
| if | Fault current [A] |
| ψαs | Alpha axis component of the stator flux [Wb] |
| ψβs | Beta axis component of the stator flux [Wb] |
| ψαr | Alpha axis component of the rotor flux, referred to the stator [Wb] |
| ψβr | Beta axis component of the rotor flux, referred to the stator [Wb] |
| ψαs2 | Flux of the short circuited turns in the phase a [Wb] |
| Rs | Stator phase resistance [Ω] |
| Rr | Rotor phase resistance, referred to the stator [Ω] |
| Rf | Fault resistance (minimum value 0, maximum value 100 Ω) |
| µ | Fault severity factor - short-circuited number of turns (minimum value 1e-4, maximum value 1) |
| Lls | Stator leakage inductance [H] |
| Lm | Magnetizing (mutual, main) inductance [H] |
| Ls | Stator phase inductance [H] ( ) |
| Lr | Rotor phase inductance, referred to the stator [H] ( ) |
| ωr | Rotor electrical speed [rad/s] ( ) |
Extras (Tab)
The Extras tab gives you the opportunity to set Signal Access Management for the component.
- Public - Components marked as public expose their signals on all levels.
- Protected - Components marked as protected will hide their signals to components outside of their first locked parent component.
- Inherit - Components marked as inherit will take the nearest parent 'signal_access' property value that is set to a value other than inherit.