> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section/im-with-saturation-section.md).

# IM with Saturation Section

## Overview

The IM with Saturation model implements a three-phase induction (asynchronous) machine with magnetizing inductance saturation in the stationary (stator) reference frame, along with the temperature effects on the stator and rotor resistances. This model includes support for resolvers and encoders. The machine can operate in both motoring mode (mechanical torque positive) and generating mode (mechanical torque negative).

## Model Description <a href="#inlineextension-model-description" id="inlineextension-model-description"></a>

Induction Machines are common electrical machines in the the automotive and transportation industry. AC Induction Motors are usually chosen because they are relatively low cost in terms of production and maintenance, and are self-starting. However, compared to Permanent Magnet Synchronous Machines, they are typically less efficient and larger in size.

The figure below illustrates the equivalent circuits of the IM with Saturation model in the synchronous (*dq*) reference frame.

<figure><img src="https://2999842053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe9Kk9pJCHht2LLBSxPap%2Fuploads%2FJ3zAL1qOhi1BlQi7znn4%2Fimage.png?alt=media&amp;token=59ec31fd-bc4f-4ad0-ae3f-9bac62a05f6e" alt=""><figcaption></figcaption></figure>

### General Equations in the Stationary Reference Frame <a href="#inlineextension-general-equations-in-the-stationary-reference-frame" id="inlineextension-general-equations-in-the-stationary-reference-frame"></a>

The stationary reference frame includes the three-phase quantities of the machine in the *abc* coordinate system, as well as the projection of these quantities onto the *α* and *β* axes, as obtained through the Clarke transformation.

### **Voltage Equations in the&#x20;*****abc*****&#x20;Stationary Reference Frame**

The voltages of the machine stator and rotor are described by the following set of general equations in the *abc* reference frame, where the variable ***Ψ*** represents the flux linkage. Note that all rotor parameters are referred to the stator, as distinguished by a prime sign.

$$
V\_{sa} = R\_s I\_{sa} + \frac{d\psi\_{sa}}{dt} \\\[8pt]

V\_{sb} = R\_s I\_{sb} + \frac{d\psi\_{sb}}{dt} \\\[8pt]

V\_{sc} = R\_s I\_{sc} + \frac{d\psi\_{sc}}{dt} \\\[8pt]

V'*{ra} = R'*r I'*{ra} + \frac{d\psi'*{ra}}{dt} \\\[8pt]

V'*{rb} = R'*r I'*{rb} + \frac{d\psi'*{rb}}{dt} \\\[8pt]

V'*{rc} = R'*r I'*{rc} + \frac{d\psi'*{rc}}{dt} \\\[8pt]
$$

For the **Squirrel-Cage Induction Machine** type, the rotor is short-circuited and it is always the case that:

$$
V'*{ra} = V'*{rb} = V'\_{rc} = 0 \\\[8pt]
$$

### **Transformation from&#x20;*****abc*****&#x20;to&#x20;*****αβ***

The Clarke transformation, shown in the equation below, is applied to obtain the *α* and *β* components of the three-phase voltages and currents.

$$
\begin{pmatrix}
\alpha \\
\beta
\end{pmatrix}
=============

\frac{2}{3}
\begin{pmatrix}
1 & -\tfrac{1}{2} & -\tfrac{1}{2} \\
0 & \tfrac{\sqrt{3}}{2} & -\tfrac{\sqrt{3}}{2}
\end{pmatrix}
\begin{pmatrix}
a \\
b \\
c
\end{pmatrix}
\\\[8pt]
$$

### **Voltage Equations in the&#x20;*****αβ*****&#x20;Stationary Reference Frame**

Using the Clarke transformation, the voltage equations for the machine stator and rotor are rewritten in the *αβ* reference frame.

$$
V\_{s\alpha} = R\_s I\_{s\alpha} + \frac{d\psi\_{s\alpha}}{dt} \\\[8pt]

V\_{s\beta} = R\_s I\_{s\beta} + \frac{d\psi\_{s\beta}}{dt} \\\[8pt]

V'*{r\alpha} = R'*r I'*{r\alpha} + \frac{d\psi'*{r\alpha}}{dt} + \omega\_r \psi'\_{r\beta} \\\[8pt]

V'*{r\beta} = R'*r I'*{r\beta} + \frac{d\psi'*{r\beta}}{dt} - \omega\_r \psi'\_{r\alpha} \\\[8pt]
$$

We consolidate the previous equations into matrix form to obtain equation, where the flux linkage matrices can be further simplified into equation. This set of equations is used to calculate the stator and rotor currents generated by the machine.

$$
\begin{bmatrix}
V\_{s\alpha} \\
V\_{s\beta} \\
V'*{r\alpha} \\
V'*{r\beta}
\end{bmatrix}
=============

\begin{bmatrix}
R\_s & 0   & 0     & 0 \\
0   & R\_s & 0     & 0 \\
0   & 0   & R'*r  & 0 \\
0   & 0   & 0     & R'*r
\end{bmatrix}
\begin{bmatrix}
I*{s\alpha} \\
I*{s\beta} \\
I'*{r\alpha} \\
I'*{r\beta}
\end{bmatrix}
\+
\frac{d}{dt}
\begin{bmatrix}
\psi\_{s\alpha} \\
\psi\_{s\beta} \\
\psi'*{r\alpha} \\
\psi'*{r\beta}
\end{bmatrix}
\+
\begin{bmatrix}
0 & 0 & 0 & 0 \\
0 & 0 & 0 & 0 \\
0 & 0 & 0 & \omega\_r \\
0 & 0 & -\omega\_r & 0
\end{bmatrix}
\begin{bmatrix}
\psi\_{s\alpha} \\
\psi\_{s\beta} \\
\psi'*{r\alpha} \\
\psi'*{r\beta}
\end{bmatrix}
\\\[8pt]

\begin{bmatrix}
\psi\_{s\alpha} \\
\psi\_{s\beta} \\
\psi'*{r\alpha} \\
\psi'*{r\beta}
\end{bmatrix}
=============

\begin{bmatrix}
L\_s & 0   & L\_m & 0 \\
0   & L\_s & 0   & L\_m \\
L\_m & 0   & L'*r & 0 \\
0   & L\_m & 0    & L'*r
\end{bmatrix}
\begin{bmatrix}
I*{s\alpha} \\
I*{s\beta} \\
I'*{r\alpha} \\
I'*{r\beta}
\end{bmatrix}
\\\[8pt]
$$

That for the **Squirrel-Cage Induction Machine** type, the rotor is short-circuited and it is once again the case that:

$$
V'*{r\alpha} = V'*{r\beta} = 0 \\\[8pt]
$$

### General Equations in the Synchronous Reference Frame <a href="#inlineextension-general-equations-in-the-synchronous-reference-frame" id="inlineextension-general-equations-in-the-synchronous-reference-frame"></a>

The synchronous reference frame is a rotating reference frame obtained through the Park transformation and denoted by the axes *d* and *q*. The orientation of the reference frame is dependent upon the configuration of the **Synchronous Reference Frame Orientation** and **Synchronous Reference Frame Offset** parameters. The user can choose to align the *d*-axis of the reference frame in the direction of the **Stator Flux**, the **Rotor Flux**, or the **Magnetizing Flux**.

**Transformation from&#x20;*****αβ*****&#x20;to&#x20;*****dq***

The transformation below is performed on the *αβ* components in the stationary reference frame to obtain the *dq* components in the synchronous reference frame. See **Reference Frame Transformations** for a complete list of transformation equations.

$$
\begin{pmatrix}
d \\
q
\end{pmatrix}
=============

\begin{pmatrix}
\cos(\theta) & \sin(\theta) \\
-\sin(\theta) & \cos(\theta)
\end{pmatrix}
\begin{pmatrix}
\alpha \\
\beta
\end{pmatrix}
\\\[8pt]
$$

When computing the *dq* quantities output from the machine model channels, the angle ***θ*** represents the sum of the estimated flux angle, ***θ***<sub>***e***</sub> , and the **Synchronous Reference Frame** **Offset**, ***θ***<sub>***offset***</sub>. The value of the estimated flux angle ***θ***<sub>***e***</sub> is dependent upon the configuration of the **Synchronous Reference Frame Orientation** parameter:

$$
\theta\_e = \arctan!\left(\frac{\psi\_{s\beta}}{\psi\_{s\alpha}}\right)
\ \text{if the reference frame is aligned with the Stator Flux}
\\\[8pt]

\theta\_e = \arctan!\left(\frac{\psi\_{r\beta}}{\psi\_{r\alpha}}\right)
\ \text{if the reference frame is aligned with the Rotor Flux}
\\\[8pt]

\theta\_e = \arctan!\left(\frac{\psi\_{m\beta}}{\psi\_{m\alpha}}\right)
\ \text{if the reference frame is aligned with the Magnetizing Flux}
\\\[8pt]
$$

where ***Ψ*** is the flux linkage.

### Electrical Angle <a href="#electrical-angle" id="electrical-angle"></a>

For all orientations of the synchronous reference frame, the value of the electrical angle is equivalent to the estimated flux angle. The quantity can also be expressed as follows:

$$
\theta\_e = \theta\_m \* PP + \int \omega\_{\text{slip}} , dt \\\[8pt]
$$

where ***θ***<sub>***m***</sub> is the mechanical angle of the machine and ***ω***<sub>***slip***</sub> is the slip speed.

### Torque Equation <a href="#torque-equation" id="torque-equation"></a>

The electromagnetic torque of the machine is described by the following equation, where ***Ψ*** is the flux linkage.

$$
T\_e = \frac{3}{2} , PP \* (\psi\_{s\alpha} I\_{s\beta} - \psi\_{s\beta} I\_{s\alpha}) \\\[8pt]
$$

### Modeling Machine Saturation <a href="#modeling-machine-saturation" id="modeling-machine-saturation"></a>

To model the effects of saturation in the machine, the *α* and *β* components of the magnetizing flux linkage, ***ψ***<sub>***mβ***</sub> and ***ψ***<sub>***mα***</sub>, are calculated from the stator and rotor flux linkages using the following equations. We use these quantities to compute the magnetizing flux linkage, ***Ψ***<sub>***m***</sub> , so that it can be passed to a look-up table generated from the parameters defined in the [**Magnetizing Inductance File \[JSON\]**](https://www.opal-rt.com/docs/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section/machine-configuration-files/magnetizing-inductance-file-json.md).

$$
\psi\_{m\alpha}
\= \psi\_{s\alpha},\frac{L\_{\alpha}}{L\_{ls}}

* \psi'*{r\alpha},\frac{L*{\alpha}}{L'\_{lr}}
  \\\[8pt]

\psi\_{m\beta}
\= \psi\_{s\beta},\frac{L\_{\beta}}{L\_{ls}}

* \psi'*{r\beta},\frac{L*{\beta}}{L'\_{lr}}
  \\\[8pt]
  $$

where Lα and Lβ are the α- and β- axis inductances such that:

$$
L\_{\alpha} = L\_{\beta}
\= \frac{L\_m,L\_{ls},L'*{lr}}
{L\_m,L*{ls} + L\_m,L'*{lr} + L*{ls},L'\_{lr}}
\\\[8pt]
$$

### Thermal Modeling of Stator and Rotor Resistances <a href="#thermal-modeling-of-stator-and-rotor-resistances" id="thermal-modeling-of-stator-and-rotor-resistances"></a>

When the **Temperature Difference** parameter ***ΔT*** is configured, the stator and rotor resistances of the machine are calculated using the following equations.

$$
R\_s = R\_{s\ nom},(1 + \alpha\_s,\Delta T) \\\[8pt]

R'*r = R'*{r\ nom},(1 + \alpha\_r,\Delta T) \\\[8pt]
$$

where:

$$\bold{\Delta T} = T\_f - T\_i$$

***R***<sub>***s***</sub> is the stator resistance at final temperature ***T***<sub>***f***</sub>

***R'***<sub>***r***</sub> is the stator resistance at final temperature ***T***<sub>***f***</sub>

***R***<sub>***snom***</sub> is the stator resistance at initial temperature ***T***<sub>***i***</sub><sub>*&#x20;*</sub><sub>*.*</sub>This value is set by the **Stator Resistance** machine parameter.

***R'***<sub>***rnom***</sub> is the rotor resistance at initial temperature ***T***<sub>***i***</sub>*.* This value is set by the **Rotor Resistance** machine parameter.

### Reference Frame Transformations <a href="#inlineextension-reference-frame-transformations" id="inlineextension-reference-frame-transformations"></a>

The transformations between the stationary three-phase reference frame (*abc*), the stationary reference frame (*αβ*), and the synchronous reference frame (*dq*) are described in the equations belo&#x77;*.* All equations are referred to the stator.

The angle ***θ*** represents the sum of the estimated flux angle, ***θ***<sub>***e***</sub> , and the **Synchronous Reference Frame Offset**, ***θ***<sub>***offset***</sub>. The value of the estimated flux angle ***θ***<sub>***e***</sub> is dependent upon the configuration of the **Synchronous Reference Frame Orientation** parameter. See **General Equations in the Synchronous Reference Frame** for more information.

#### ***abc*****&#x20;to&#x20;*****dq***

The Park transformation and its inverse, shown below, are applied to transform the stationary three-phase reference frame (*abc*) to the synchronous reference frame (*dq*) and vice-versa.

$$
\begin{pmatrix}
d \\
q
\end{pmatrix}
=============

\frac{2}{3}
\begin{pmatrix}
\cos(\theta) & \cos!\left(\theta - \tfrac{2\pi}{3}\right) & \cos!\left(\theta + \tfrac{2\pi}{3}\right) \\
-\sin(\theta) & -\sin!\left(\theta - \tfrac{2\pi}{3}\right) & -\sin!\left(\theta + \tfrac{2\pi}{3}\right)
\end{pmatrix}
\begin{pmatrix}
a \\
b \\
c
\end{pmatrix}
\\\[8pt]

\begin{pmatrix}
a \\
b \\
c
\end{pmatrix}
=============

\begin{pmatrix}
\cos(\theta) & -\sin(\theta) \\
\cos!\left(\theta - \tfrac{2\pi}{3}\right) & -\sin!\left(\theta - \tfrac{2\pi}{3}\right) \\
\cos!\left(\theta + \tfrac{2\pi}{3}\right) & -\sin!\left(\theta + \tfrac{2\pi}{3}\right)
\end{pmatrix}
\begin{pmatrix}
d \\
q
\end{pmatrix}
\\\[8pt]
$$

#### ***abc*****&#x20;to&#x20;*****αβ***

We can set ***θ*** = 0 to further reduce the previuos equations. The resulting equations allow us to project the three-phase *abc* components onto a stationary two-axis reference frame, *αβ*.

$$
\begin{pmatrix}
\alpha \\
\beta
\end{pmatrix}
=============

\frac{2}{3}
\begin{pmatrix}
1 & -\tfrac{1}{2} & -\tfrac{1}{2} \\
0 & \tfrac{\sqrt{3}}{2} & -\tfrac{\sqrt{3}}{2}
\end{pmatrix}
\begin{pmatrix}
a \\
b \\
c
\end{pmatrix}
\\\[8pt]

\begin{pmatrix}
a \\
b \\
c
\end{pmatrix}
=============

\begin{pmatrix}
1 & 0 \\
-\tfrac{1}{2} & \tfrac{\sqrt{3}}{2} \\
-\tfrac{1}{2} & -\tfrac{\sqrt{3}}{2}
\end{pmatrix}
\begin{pmatrix}
\alpha \\
\beta
\end{pmatrix}
\\\[8pt]
$$

#### ***αβ*****&#x20;to&#x20;*****dq***

The transformations shown below are used to transform the *αβ* components in the stationary reference frame to *dq* components in the synchronous reference frame, and vice versa.

$$
\begin{pmatrix}
d \\
q
\end{pmatrix}
=============

\begin{pmatrix}
\cos(\theta) & \sin(\theta) \\
-\sin(\theta) & \cos(\theta)
\end{pmatrix}
\begin{pmatrix}
\alpha \\
\beta
\end{pmatrix}
\\\[8pt]

\begin{pmatrix}
\alpha \\
\beta
\end{pmatrix}
=============

\begin{pmatrix}
\cos(\theta) & -\sin(\theta) \\
\sin(\theta) & \cos(\theta)
\end{pmatrix}
\begin{pmatrix}
d \\
q
\end{pmatrix}
\\\[8pt]
$$

## Parameters

In the System Explorer window configuration tree, expand the Power Electronics Add-On custom device and select **Circuit Model >> IM with Saturation** to display this page. Use this page to configure the Induction Machine with Saturation model.

This page includes the following components, configurable at edit-time only:

### Machine Model Settings

<table><thead><tr><th width="220.22216796875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>Specifies the name of the machine model.</td></tr><tr><td><strong>Description</strong></td><td>Specifies a description for the machine model.</td></tr></tbody></table>

### Machine Configuration

<table><thead><tr><th width="220.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Machine Type</strong></td><td>Choose from one of the following types: - Squirrel-Cage Induction Machine, (Default Value: Squirrel-Cage Induction Machine)</td></tr><tr><td><strong>Enable</strong></td><td>Indicates whether the selected machine model is enabled. When a machine is enabled, it computes and generates output data at the specified Applied Solver Timestep. Because up to four machines can be simulated at once, the number of enabled machines impacts the minimum achievable time step of each machine, (Default Value: True)</td></tr><tr><td><strong>Enable Advanced Channels</strong></td><td>Exposes additional parameters as tunable VeriStand Channels. See the Advanced Channels section below for more details. This setting also enables the Temperature Difference configuration parameter, (Default Value: False)</td></tr><tr><td><strong>Magnetizing Inductance File Path</strong></td><td>Specifies the path to the Magnetizing Inductance JSON file defining the saturation parameters of the machine. Refer to <a href="https://www.opal-rt.com/docs/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section/machine-configuration-files/magnetizing-inductance-file-json.md">Magnetizing Inductance File JSON</a> for details regarding the file format.</td></tr><tr><td><strong>Stator Resistance (R</strong><sub><strong>s</strong></sub><strong>)</strong></td><td>Stator winding resistance of phases A, B, and C, (Ω) (Default Value: 0.087)</td></tr><tr><td><strong>Stator Leakage Inductance (L</strong><sub><strong>ls</strong></sub><strong>)</strong></td><td>Stator winding leakage inductance of phases A, B, and C, (H) (Default Value: 0.00035)</td></tr><tr><td><strong>Rotor Resistance (R'</strong><sub><strong>r</strong></sub><strong>)</strong></td><td>Equivalent rotor winding resistance of phases A, B, and C, referred to the stator' (Ω) (Default Value: 0.228)</td></tr><tr><td><strong>Rotor Leakage Inductance (L'</strong><sub><strong>lr</strong></sub><strong>)</strong></td><td>Equivalent rotor winding leakage inductance of phases A, B, and C, referred to the stator, (H) (Default Value: 0.00035)</td></tr><tr><td><strong>Pole Pairs (PP)</strong></td><td>Number of machine pole pairs, (Default Value: 2)</td></tr><tr><td><strong>Magnetizing Inductance Cutoff Frequency (F</strong><sub><strong>cLm</strong></sub><strong>)</strong></td><td>Cut-off frequency associated with the frequency response of the magnetic coil, which acts as a filtering element, (Hz) (Default Value: 3000)</td></tr><tr><td><strong>Synchronous Reference Frame Orientation</strong></td><td>Configures the orientation of the synchronous (dq) reference frame. The direct-axis of the dq reference frame can be aligned in the direction of one of the following: - Stator Flux - Rotor Flux - Magnetizing Flux, (Default Value: Stator Flux)</td></tr><tr><td><strong>Synchronous Reference Frame Offset (θ</strong><sub><strong>offset</strong></sub><strong>)</strong></td><td>Offset angle applied to the estimated synchronous angle. By default, the offset is 0°, indicating that the direct-axis is aligned with phase A when the rotor angle is 0. Setting the parameter to -90° indicates that the quadrature-axis is aligned with phase A when the rotor angle is 0, (deg) (Default Value: 0)</td></tr><tr><td><strong>Stator Rotor Turn Ratio (N</strong><sub><strong>sr</strong></sub><strong>)</strong></td><td>Stator to rotor winding turn ratio, (Default Value: 1)</td></tr><tr><td><strong>Temperature Difference (ΔT)</strong></td><td>Temperature difference with respect to the initial temperature of stator and rotor windings. This parameter is made available when Enable Advanced Channels is enabled, (ºC) (Default Value: 0)</td></tr><tr><td><strong>Rotor Temperature Coefficient (α</strong><sub><strong>r</strong></sub><strong>)</strong></td><td>Temperature coefficient of resistance of the rotor winding material, (°C^-1) (Default Value: 0)</td></tr><tr><td><strong>Stator Temperature Coefficient (α</strong><sub><strong>s</strong></sub><strong>)</strong></td><td>Temperature coefficient of resistance of the stator winding material, (°C^-1) (Default Value: 0)</td></tr><tr><td><strong>Applied Solver Timestep (T</strong><sub><strong>s</strong></sub><strong>)</strong></td><td>The timestep at which the machine model executes. New outputs are computed by the FPGA machine model at each timestep. If <a href="broken://pages/2c00b86bc74cbf4dd47f681320e80388fe13e3fa">Optimize Solver Timestep</a> is enabled in the Circuit Model page, the Applied Solver Timestep is automatically set to an optimal value and cannot be edited, (s) (Default Value: 4.81E-7)</td></tr><tr><td><strong>Minimum Solver Timestep (T</strong><sub><strong>sm</strong></sub><strong>)</strong></td><td>The minimum achievable timestep at which the machine model can execute when all four machines are enabled. The minimum achievable timestep is a function of the number of enabled machines, (s) (Default Value: 4.81E-7)</td></tr></tbody></table>

### Input Mapping Configuration

Use the Input Mapping Configuration to route signals to the Voltage Phase A, Voltage Phase B, and Voltage Phase C inputs of the machine model. Available routing options may vary depending on the selected Hardware Configuration.

<table><thead><tr><th width="219.77777099609375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Group</strong></td><td><p>Specifies the group that will be routed to the input voltages of the machine. The available routing options are defined by the selected Hardware Configuration, however it is typical to see the following options by default:</p><ul><li><strong>Measurements</strong> - eHS circuit model measurements</li></ul></td></tr><tr><td><strong>Element</strong></td><td>Specifies the index of the measurement in the group that has been selected as the input voltage of the machine.</td></tr></tbody></table>

## Section Channels

This section includes the following custom device channels:

<table><thead><tr><th width="221.02215576171875">Channel Name</th><th>Description</th></tr></thead><tbody><tr><td><strong>Stator Current Phase A (Output)</strong></td><td>Phase A stator current, Isa (A) (Default Value: 0)</td></tr><tr><td><strong>Stator Current Phase B (Output)</strong></td><td>Phase B stator current, Isb (A) (Default Value: 0)</td></tr><tr><td><strong>Stator Current Phase C (Output)</strong></td><td>Phase C stator current, Isc (A) (Default Value: 0)</td></tr><tr><td><strong>Stator Direct Axis Current (Output)</strong></td><td>Direct-axis stator current, as defined by the synchronous reference frame, Isd (A) (Default Value: 0)</td></tr><tr><td><strong>Stator Quadrature Axis Current (Output)</strong></td><td>Quadrature-axis stator current, as defined by the synchronous reference frame, Isq (A) (Default Value: 0)</td></tr><tr><td><strong>Stator Alpha Voltage (Output)</strong></td><td>Stator voltage in the alpha direction defined by the stationary reference frame, Vsα (V) (Default Value: 0)</td></tr><tr><td><strong>Stator Beta Voltage (Output)</strong></td><td>Stator voltage in the beta direction defined by the stationary reference frame, Vsβ (V) (Default Value: 0)</td></tr><tr><td><strong>Stator Alpha Flux (Output)</strong></td><td>Stator flux in the alpha direction defined by the stationary reference frame, Φsα (Wb) (Default Value: 0)</td></tr><tr><td><strong>Stator Beta Flux (Output)</strong></td><td>Stator current in the beta direction defined by the stationary reference frame, Φsβ (Wb) (Default Value: 0)</td></tr><tr><td><strong>Stator Alpha Current (Output)</strong></td><td>Stator current in the alpha direction defined by the stationary reference frame, Isα (A) (Default Value: 0)</td></tr><tr><td><strong>Stator Beta Current (Output)</strong></td><td>Stator voltage in the beta direction defined by the stationary reference frame, Isβ (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Current Phase A (Output)</strong></td><td>Phase A rotor current referred to the stator, I'ra (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Current Phase B (Output)</strong></td><td>Phase B rotor current referred to the stator, I'rb (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Current Phase C (Output)</strong></td><td>Phase C rotor current referred to the stator, I'rc (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Direct Axis Current (Output)</strong></td><td>Direct-axis rotor current referred to the stator, I'rd (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Quadrature Axis Current (Output)</strong></td><td>Quadrature-axis rotor current referred to the stator, I'rq (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Alpha Voltage (Output)</strong></td><td>Rotor voltage in the alpha direction defined by the stationary reference frame, V'rα (V) (Default Value: 0)</td></tr><tr><td><strong>Rotor Beta Voltage (Output)</strong></td><td>Rotor voltage in the beta direction defined by the stationary reference frame, V'rβ (V) (Default Value: 0)</td></tr><tr><td><strong>Rotor Alpha Flux (Output)</strong></td><td>Rotor flux in the alpha direction defined by the stationary reference frame, Φ'rα (WB) (Default Value: 0)</td></tr><tr><td><strong>Rotor Beta Flux (Output)</strong></td><td>Rotor flux in the beta direction defined by the stationary reference frame, Φ'rβ (Wb) (Default Value: 0)</td></tr><tr><td><strong>Rotor Alpha Current (Output)</strong></td><td>Rotor current in the alpha direction defined by the stationary reference frame, I'rα (A) (Default Value: 0)</td></tr><tr><td><strong>Rotor Beta Current (Output)</strong></td><td>Rotor current in the beta direction defined by the stationary reference frame, I'rβ (A) (Default Value: 0)</td></tr></tbody></table>

### Advanced Channels

The following VeriStand channels are displayed under the Advanced section when the Enable Advanced Channels option is enabled on the IM with Saturation configuration page. Channel values can be modified dynamically at execution time.

<table><thead><tr><th width="218.711181640625">Channel Name</th><th>Description</th></tr></thead><tbody><tr><td><p><strong>Stator Resistance Override</strong></p><p><strong>(Input)</strong></p></td><td>Overrides the Stator Resistance parameter defined in the Configuration page for the machine. When the simulation is started, the value of this channel is automatically updated to reflect the value of the Stator Resistance parameter defined in the machine Configuration page. Changes made to the value of this channel during the simulation take effect immediately, Rs (Ω) (Default Value: 0.087)</td></tr><tr><td><p><strong>Rotor Resistance Override</strong></p><p><strong>(Input)</strong></p></td><td>Overrides the Rotor Resistance parameter defined in the Configuration page for the machine. When the simulation is started, the value of this channel is automatically updated to reflect the value of the Rotor Resistance parameter defined in the machine Configuration page. Changes made to the value of this channel during the simulation take effect immediately, R'r (Ω) (Default Value: 0.228)</td></tr><tr><td><p><strong>Temperature Difference Override</strong></p><p><strong>(Input)</strong></p></td><td><p>Overrides the <strong>Temperature Difference</strong> parameter defined in the Configuration page for the machine.</p><p>When the simulation is started, the value of this channel is automatically updated to reflect the value of the <strong>Temperature Difference</strong> parameter defined in the machine Configuration page. Changes made to the value of this channel during the simulation take effect immediately, ΔT (ºC) (Default Value: 0)</p></td></tr><tr><td><p><strong>Stator Leakage Inductance Override</strong></p><p><strong>(Input)</strong></p></td><td><p>Overrides the <strong>Stator Leakage Inductance</strong> parameter defined in the Configuration page for the machine.</p><p>When the simulation is started, the value of this channel is automatically updated to reflect the value of the <strong>Stator Leakage Inductance</strong> parameter defined in the machine Configuration page. Changes made to the value of this channel during the simulation take effect immediately, L<sub>ls</sub> (H) (Default Value: 0.00035)</p></td></tr><tr><td><p><strong>Rotor Leakage Inductance Override</strong></p><p><strong>(Input)</strong></p></td><td><p>Overrides the <strong>Rotor Leakage Inductance</strong> parameter defined in the Configuration page for the machine.</p><p>When the simulation is started, the value of this channel is automatically updated to reflect the value of the <strong>Rotor Leakage Inductance</strong> parameter defined in the machine Configuration page. Changes made to the value of this channel during the simulation take effect immediately, L'<sub>lr</sub> (H) (Default Value: 0.00035)</p></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/pe-add-on-simulink/model-and-simulation/add-and-configure-a-circuit-model-to-the-system-definition/machine-section/im-with-saturation-section.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
