> 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/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/ac-drives/field-oriented-control-induction-motor-drive.md).

# Field-Oriented Control Induction Motor Drive

## Description

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-c44a28e8481887ca3aee8036582100633010319f%2FAC3_motor_drive.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Field-Oriented Control Induction Motor Drive** block, located in the **OPAL-RT SPS Software/Electrical Machines/Control/AC Drives** library, commonly called the **AC3 motor drive**, models a standard vector or rotor field-oriented control drive for induction motors.

This drive features closed-loop speed control based on the indirect or feedforward vector control method. The speed control loop outputs the reference electromagnetic torque and rotor flux of the machine. The reference direct and quadrature (dq) components of the stator current, corresponding to the commanded rotor flux and torque, are derived based on the indirect vector control strategy. The reference dq components of the stator current are then used to obtain the required gate signals for the inverter through a hysteresis-band or PWM current controller.

The main advantage of this drive compared to scalar-controlled drives is its fast dynamic response. The inherent coupling effect between the torque and flux in the machine is managed through decoupling (rotor flux orientation) control, which allows the torque and flux to be controlled independently. However, due to its computation complexity, the implementation of this drive requires fast computing processors or DSPs.

<figure><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-ab6b3a6ed38ab4a1720f5f0512c168a88ca971d3%2FAC3_motor_drive_model.png?alt=media" alt=""><figcaption></figcaption></figure>

The Field-Oriented Control Induction Motor Drive block uses these blocks from the Electric Drives / Fundamental Drive Blocks library:

* Speed Controller (AC)
* Field-Oriented Controller
* DC Bus
* Inverter (Three-Phase)

The model is discrete. Good simulation results have been obtained with a 2 *µ*s time step. To simulate a digital controller device, the control system has two different sampling times:

* Speed controller sampling time
* FOC sampling time

The speed controller sampling time has to be a multiple of the FOC sampling time. The latter sampling time has to be a multiple of the simulation time step. The average-value inverter allows the use of bigger simulation time steps since it does not generate small time constants (due to the RC snubbers) inherent to the detailed converter. For an FOC sampling time of 60 µs, good simulation results have been obtained for a simulation time step of 60 µs. This time step cannot be higher than the FOC time step.

### Model Specifications <a href="#model-specifications" id="model-specifications"></a>

The library contains a 3 hp and a 200-hp drive parameter set. The specifications of these two drives are shown in the following table.

**3 HP and 200 HP Drive Specifications**

|                          | 3 HP Drive                                              | 200 HP Drive                                              |
| ------------------------ | ------------------------------------------------------- | --------------------------------------------------------- |
| **Drive Input Voltage**  | <p>Amplitude: 220 V<br>Frequency: 60 Hz</p>             | <p>Amplitude: 575 V<br>Frequency: 60 Hz</p>               |
| **Motor Nominal Values** | <p>Power: 3 hp<br>Speed: 1705 rpm<br>Voltage: 220 V</p> | <p>Power: 200 hp<br>Speed: 1785 rpm<br>Voltage: 575 V</p> |

## Parameters <a href="#parameters" id="parameters"></a>

### General <a href="#general" id="general"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Output bus mode</strong></td><td>Select how the output variables are organized.<br>If you select <strong>Multiple output buses</strong> (default), the block has three separate output buses for motor, converter, and controller variables.<br>If you select <strong>Single output bus</strong>, all variables output on a single bus.</td></tr><tr><td><strong>Model detail level</strong></td><td>Select between the detailed and the average-value inverter. Default is Detailed.</td></tr><tr><td><strong>Mechanical input</strong></td><td><p>Select between the load torque, the motor speed and the mechanical rotational port as mechanical input. Default is Torque Tm.</p><p>If you select and apply a <strong>load torque</strong>, the output is the motor speed according to the following differential equation that describes the mechanical system dynamics:</p><p><span class="math">T_e=J\frac{d}{dt}\omega_r+F\omega_r+T_m \\[4pt]</span></p><p>This mechanical system is included in the motor model.</p><p>If you select the <strong>motor speed</strong> as mechanical input, then you get the electromagnetic torque as output, allowing you to represent externally the mechanical system dynamics. The internal mechanical system is not used with this mechanical input selection and the inertia and viscous friction parameters are not displayed.</p><p>For the <strong>mechanical rotational port</strong>, the connection port S counts for the mechanical input and output. It allows a direct connection to the Simscape environment. The mechanical system of the motor is also included in the drive and is based on the same differential equation.</p><p>See <a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/library-specific-guides/motor-drives/mechanical-coupling-of-two-motor-drives.md">Mechanical Coupling of Two Motor Drives.</a></p></td></tr><tr><td><strong>Use bus as labels</strong></td><td><p>When you select this check box, the <strong>Motor</strong>, <strong>Conv</strong>, and <strong>Ctrl</strong> measurement outputs use the signal names to identify the bus labels. Select this option for applications that require bus signal labels to have only alphanumeric characters.</p><p>When this check box is cleared (default), the measurement output uses the signal definition to identify the bus labels. The labels contain non-alphanumeric characters that are incompatible with some Simulink<sup>®</sup> applications.</p></td></tr><tr><td><strong>Set sensorless</strong></td><td><p>When you select this check box, the motor speed is estimated from terminal voltages and currents based on the Model Referencing Adaptive System (MRAS) technique. The <strong>Sensorless</strong> tab contains the estimator controller parameters.</p><p>When this check box is cleared, the motor speed is measured by an internal speed sensor, and the <strong>Sensorless</strong> tab is not displayed on the block mask.</p></td></tr></tbody></table>

### Asynchronous Machine Tab <a href="#asynchronous-machine-tab" id="asynchronous-machine-tab"></a>

The **Asynchronous Machine** tab displays the parameters of the Asynchronous Machine block of the Fundamental Blocks (powerlib) library.

### Converters and DC Bus Tab <a href="#converters-and-dc-bus-tab" id="converters-and-dc-bus-tab"></a>

#### **Rectifier Section**

The **Rectifier** section of the **Converters and DC Bus** tab displays the parameters of the [Universal Bridge](https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551828422) block of the Fundamental Blocks (powerlib) library. For more information on the universal bridge parameters, refer to the Universal Bridge reference page.

#### **DC Bus Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Capacitance</strong></td><td>The DC bus capacitance (F). Default is <code>2000e-6</code>.</td></tr></tbody></table>

#### **Braking Chopper Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Resistance</strong></td><td>The braking chopper resistance used to avoid bus over-voltage during motor deceleration or when the load torque tends to accelerate the motor (ohms). Default is <code>8</code>.</td></tr><tr><td><strong>Chopper frequency</strong></td><td>The braking chopper frequency (Hz). Default is <code>4000</code>.</td></tr><tr><td><strong>Activation voltage</strong></td><td>The dynamic braking is activated when the bus voltage reaches the upper limit of the hysteresis band (V). The following figure illustrates the braking chopper hysteresis logic. Default is <code>320</code>.</td></tr><tr><td><strong>Shutdown voltage</strong></td><td><p>The dynamic braking is shut down when the bus voltage reaches the lower limit of the hysteresis band (V). The Chopper hysteresis logic is shown in the next figure. Default is <code>310</code>.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-32b69cc9d0cb29cbe503a85e82d4c5c3abfe1ced%2FAC3_shutdownvoltage.png?alt=media" alt="" data-size="original"></p></td></tr></tbody></table>

#### **Inverter Section**

The **Inverter** section of the **Converters and DC Bus** tab displays the parameters of the Universal Bridge block of the Fundamental Blocks (powerlib) library. For more information on the universal bridge parameters, refer to the [Universal Bridge](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/power-converters/switches/universal-bridge.md) block page.

The average-value inverter uses the following parameters.

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Source frequency</strong></td><td>The frequency of the three-phase voltage source (Hz). Default is <code>60</code>.</td></tr><tr><td><strong>On-state resistance</strong></td><td>The on-state resistance of the inverter switches (ohms). Default is <code>1e-3</code>.</td></tr></tbody></table>

### Controller Tab <a href="#controller-tab" id="controller-tab"></a>

<table data-header-hidden><thead><tr><th width="220.22216796875"></th><th></th></tr></thead><tbody><tr><td><strong>Regulation Type</strong></td><td>This pop-up menu allows you to choose between speed and torque regulation. Default is <code>Speed regulation</code>.</td></tr><tr><td><strong>Modulation type</strong></td><td>Select hysteresis or space vector modulation. The default modulation type is <code>Hysteresis</code>.</td></tr><tr><td><strong>Schematic</strong></td><td>When you click this button, a diagram illustrating the speed and current controllers schematics appears.</td></tr></tbody></table>

#### **Speed Controller Section**

<table data-header-hidden><thead><tr><th width="199.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Speed Ramps — Acceleration</strong></td><td>The maximum change of speed allowed during motor acceleration (rpm/s). An excessively large positive value can cause DC bus under-voltage. This parameter is used in speed regulation mode only. Default is <code>900</code>.</td></tr><tr><td><strong>Speed Ramps — Deceleration</strong></td><td>The maximum change of speed allowed during motor deceleration (rpm/s). An excessively large negative value can cause DC bus overvoltage. This parameter is used in speed regulation mode only. Default is <code>-900</code>.</td></tr><tr><td><strong>Speed cutoff frequency</strong></td><td>The speed measurement first-order low-pass filter cutoff frequency (Hz). This parameter is used in speed regulation mode only. Default is <code>1000</code>.</td></tr><tr><td><strong>Speed controller sampling time</strong></td><td>The speed controller sampling time (s). The sampling time must be a multiple of the simulation time step. Default is <code>100e-6</code>.</td></tr><tr><td><strong>PI regulator — Proportional gain</strong></td><td>The speed controller proportional gain. This parameter is used in speed regulation mode only. Default is <code>300</code>.</td></tr><tr><td><strong>PI regulator — Integral gain</strong></td><td>The speed controller integral gain. This parameter is used in speed regulation mode only. Default is <code>2000</code>.</td></tr><tr><td><strong>Torque output limits — Negative</strong></td><td>The maximum negative demanded torque applied to the motor by the current controller (N.m). Default is <code>-1200</code>.</td></tr><tr><td><strong>Torque output limits — Positive</strong></td><td>The maximum positive demanded torque applied to the motor by the current controller (N.m). Default is <code>1200</code>.</td></tr></tbody></table>

#### **Field Oriented Control Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Flux Controller — Proportional gain</strong></td><td>The flux controller proportional gain. Default is <code>100</code>.</td></tr><tr><td><strong>Flux Controller — Integral gain</strong></td><td>The flux controller integral gain. Default is <code>30</code>.</td></tr><tr><td><strong>Flux output limits — Negative</strong></td><td>The flux controller maximum negative output (Wb). Default is <code>-2</code>.</td></tr><tr><td><strong>Flux output limits — Positive</strong></td><td>The flux controller maximum positive output (Wb). Default is <code>2</code>.</td></tr><tr><td><strong>Lowpass filter cutoff frequency</strong></td><td>The flux estimation first-order filter cutoff frequency (Hz). Default is <code>16</code>.</td></tr><tr><td><strong>Sampling Time</strong></td><td>The FOC controller sampling time (s). The sampling time must be a multiple of the simulation time step. Default is <code>20e-6</code>.</td></tr><tr><td><strong>Current controller hysteresis band</strong></td><td><p>The current hysteresis bandwidth. This value is the total bandwidth distributed symmetrically around the current set point (A). Default is <code>10</code>. The following figure illustrates a case where the current set point is Is*and the current hysteresis bandwidth is set to dx.</p><p>This parameter is not used when using the average-value inverter.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-65f778df8279ac91a2a691d00e4198b8ba6d87d2%2FAC3_current_controller.png?alt=media" alt="" data-size="original"></p></td></tr><tr><td><strong>Maximum switching frequency</strong></td><td>The maximum inverter switching frequency (Hz). This parameter is not used when using the average-value inverter. Default is <code>20000</code>.</td></tr><tr><td><strong>Show/Hide Autotuning Control</strong></td><td>Select to show or hide the parameters of the Autotuning Control tool.</td></tr></tbody></table>

#### **Autotuning of PI loops Section**

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Desired damping [zeta]</strong></td><td>Specify the damping factor used for the calculation of the Kp and Ki gains of the Speed Controller (AC) block. Default is <code>0.9</code>.</td></tr><tr><td><strong>Desired response time @ 5% [Trd (sec)]</strong></td><td>Specify the desired settling time of the Speed Controller (AC) block. This is time required for the controller response to reach and stay within a 5 percent range of the target value. Default is <code>0.1</code>.</td></tr><tr><td><strong>Bandwidth ratio (InnerLoop/SpeedLoop)</strong></td><td>Specify the ratio between the bandwidth and natural frequency of the regulator. Default is <code>30</code>.</td></tr><tr><td><strong>Calculate PI regulator gains</strong></td><td>Compute the <strong>Proportional gain</strong> and <strong>Integral gain</strong> parameters of the Speed Controller (AC) and of the Field-Oriented Controller blocks. The computation is based on the <strong>Desired damping [zeta]</strong>, <strong>Desired response time @ 5%</strong>, and <strong>Bandwidth ratio (InnerLoop/SpeedLoop)</strong> parameters. The computed values are displayed in the mask of the Drive block. Click <strong>Apply</strong> or <strong>OK</strong> to confirm them.</td></tr></tbody></table>

### Sensorless Tab <a href="#sensorless-tab" id="sensorless-tab"></a>

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Proportional gain</strong></td><td><p>Specify the value of the proportional gain of the PI regulator that is used to tune the motor speed.</p><p>Default is <code>5000</code>.</p></td></tr><tr><td><strong>Integral gain</strong></td><td><p>Specify the value of the integral gain of the PI regulator that is used to tune the motor speed.</p><p>Default is <code>50</code>.</p></td></tr><tr><td><strong>Upper - Upper output limit</strong></td><td><p>Specify the upper output limit of the PI controller.</p><p>Default is <code>500</code>.</p></td></tr><tr><td><strong>Lower - Lower output limit</strong></td><td><p>Specify the lower output limit of the PI controller.</p><p>Default is <code>-500</code>.</p></td></tr><tr><td><strong>Controller sample time</strong></td><td>Controller sample time, in s. The sample time must be a multiple of the simulation time step. Default is <code>2e-06</code>.</td></tr></tbody></table>

## Inputs

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>SP</strong></td><td>The speed or torque set point. The speed set point can be a step function, but the speed change rate will follow the acceleration / deceleration ramps.<br>If the load torque and the speed have opposite signs, the accelerating torque will be the sum of the electromagnetic and load torques.</td></tr><tr><td><strong>Tm</strong> or <strong>Wm</strong></td><td>The mechanical input: load torque (Tm) or motor speed (Wm).<br>For the mechanical rotational port (S), this input is deleted.</td></tr><tr><td><strong>A, B, C</strong></td><td>The three phase terminals of the motor drive.</td></tr></tbody></table>

## Outputs

<table data-header-hidden><thead><tr><th width="220.22222900390625"></th><th></th></tr></thead><tbody><tr><td><strong>Wm</strong>, <strong>Te</strong> or <strong>S</strong></td><td>The mechanical output: motor speed (Wm), electromagnetic torque (Te) or mechanical rotational port (S).</td></tr><tr><td><strong>Motor*</strong></td><td>if <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The motor measurement vector. This vector allows you to observe the motor’s variables using the Bus Selector block.</td></tr><tr><td><strong>Conv*</strong></td><td><p>if <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong><br>The three-phase converters measurement vector. This vector contains:</p><ul><li>The rectifier output voltage</li><li>The inverter output voltage</li><li>The rectifier input current</li><li>The inverter output current</li></ul><p>Note that all current and voltage values of the bridges can be visualized with the Multimeter block.</p></td></tr><tr><td><strong>Ctrl*</strong></td><td><p>if <strong>Output bus mode</strong> parameter is set to <strong>Multiple output buses</strong></p><p>The controller measurement vector. This vector contains:</p><ul><li>The firing angle computed by the current controller</li><li>The speed error (difference between the speed reference ramp and actual speed)</li><li>The speed reference ramp</li></ul></td></tr></tbody></table>

**\*** When the **Output bus mode parameter** is set to **Single output bus**, the block groups the Motor, Conv, and Ctrl outputs into a single bus output.

## Examples <a href="#examples" id="examples"></a>

The AC3 - Field-Oriented Control Induction 200 HP Motor Drive (ac3\_example) example illustrates an AC3 motor drive simulation with standard load conditions for the detailed and average-value models.

## References <a href="#references" id="references"></a>

\[1] Bose, B. K. *Modern Power Electronics and AC Drives*. Upper Saddle River, NJ: Prentice-Hall, 2002.

\[2] Grelet, G., and G. Clerc. *Actionneurs électriques*. Paris: Éditions Eyrolles, 1997.

\[3] Krause, P. C. *Analysis of Electric Machinery*. New York: McGraw-Hill, 1986.<br>


---

# 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/smart-power-simulation-software-sps/blocks-functions-tools/machines/blocks/machines-control/ac-drives/field-oriented-control-induction-motor-drive.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.
