> 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/renewables/wind-turbine-induction-generator-phasor-type.md).

# Wind Turbine Induction Generator (Phasor Type)

## Description

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

The **Wind Turbine Induction Generator (Phasor Type) block**, located in the **OPAL-RT SPS Software/Sources** library, implements a phasor model of squirrel-cage induction generator driven by variable pitch wind turbine.

The wind turbine and the induction generator (WTIG) are shown below.

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

The stator winding is connected directly to the grid and the rotor is driven by the wind turbine.

The power captured by the wind turbine is converted into electrical power by the induction generator and is transmitted to the grid by the stator winding.

The pitch angle is controlled in order to limit the generator output power to its nominal value for high wind speeds.

In order to generate power the induction generator speed must be slightly above the synchronous speed. But the speed variation is typically so small that the WTIG is considered to be a fixed-speed wind generator.

The reactive power absorbed by the induction generator is provided by the grid or by some devices like capacitor banks, SVC, STATCOM, or synchronous condenser.

### Pitch Angle Control System

The wind turbine model uses the [Wind Turbine](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/renewables/wind-turbine.md) block of the Renewables/Wind Generation library. See documentation of this block for details.

A Proportional-Integral (PI) controller is used to control the blade pitch angle in order to limit the electric output power to the nominal mechanical power.

The pitch angle is kept constant at zero degrees when the measured electric output power is under its nominal value. When it increases above its nominal value, the PI controller increases the pitch angle to bring back the measured power to its nominal value.

The control system is illustrated in the figure below:

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

## Ports

### Input

<table data-header-hidden><thead><tr><th width="249.7777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>wind</strong> — Wind signal<br>Simulink<sup>®</sup> signal</td><td><p>Simulink input of the wind speed in m/s.</p><p><strong>Dependencies</strong> To enable this port, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Tm</strong> — Mechanical load torque<br>Simulink signal</td><td><p>Simulink input of the mechanical torque.</p><p>Tm must be negative for power generation. Use this input when using an external turbine model.</p><p><strong>Dependencies</strong> To enable this port, select the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Trip</strong> — Mechanical load torque<br>0 | 1</td><td><p>Apply a Simulink logical signal (0 or 1) to this input.</p><p>When this input is high the WTIG is disconnected.</p><p>Use this input to implement a simplified version of the protection system.</p></td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="249.5555419921875"></th><th></th></tr></thead><tbody><tr><td><strong>m</strong> — Measurement signal<br>vector</td><td>Simulink output vector containing 8 WTIG internal signals. These signals can be individually accessed by using the Bus Selector block. They are, in order:</td></tr></tbody></table>

<table data-header-hidden><thead><tr><th width="143.4444580078125"></th><th width="199.7777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Signal</strong></td><td><strong>Signal Names</strong></td><td><strong>Definition</strong></td></tr><tr><td>1</td><td>Vabc (cmplx) (pu)</td><td>Phasor voltages (phase to ground) Va, Vb, Vc at the WTIG terminals in pu based on the generator ratings.</td></tr><tr><td>2</td><td>Iabc (cmplx) (pu)</td><td>Phasor currents Ia, Ib, Ic flowing into the WTIG terminals in pu based on the generator ratings.</td></tr><tr><td>3</td><td>P (pu)</td><td>WTIG output power in pu based on the generator ratings. A positive value indicates power generation.</td></tr><tr><td>4</td><td>Q (pu)</td><td>WTIG output reactive power in pu based on the generator ratings. A positive value indicates reactive power generation.</td></tr><tr><td>5</td><td>wr (pu)</td><td>Generator rotor speed (pu)</td></tr><tr><td>6</td><td>Tm (pu)</td><td>Mechanical torque applied to the generator in pu based on the generator ratings.</td></tr><tr><td>7</td><td>Te (pu)</td><td>Electromagnetic torque in pu based on the generator ratings.</td></tr><tr><td>8</td><td>Pitch_angle (deg)</td><td>Blade pitch angle in degrees.</td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="250.177734375"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Terminal A<br>SPS electrical</td><td>SPS electrical conserving port associated with the terminal A of the WTIG.</td></tr><tr><td><strong>B</strong> — Terminal B<br>SPS electrical</td><td>SPS electrical conserving port associated with the terminal B of the WTIG.</td></tr><tr><td><strong>C</strong> — Terminal C<br>SPS electrical</td><td>SPS electrical conserving port associated with the terminal C of the WTIG.</td></tr></tbody></table>

## Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink Toolstrip, on the **Simulation** tab, in the **Prepare** gallery, select **Property Inspector**.

### Generator

<table data-header-hidden><thead><tr><th width="250.44439697265625"></th><th></th></tr></thead><tbody><tr><td><strong>External turbine (Tm mechanical torque input)</strong> — Option to use external turbine<br>off (default) | on</td><td><p>When this parameter is selected, the <strong>Turbine</strong> tab is not visible in the mask dialog box, and a Simulink input named Tm appears on the block, allowing to use an external signal for the generator input mechanical torque.</p><p>This external torque must be in pu based on the nominal electric power and synchronous speed of the generator.</p><p>For example, the external torque may come from a user defined turbine model.</p><p>By convention for the induction machine, the torque must be negative for power generation</p></td></tr><tr><td><strong>Nominal power, line-to-line voltage and frequency [Pn(VA), Vn(Vrms), fn(Hz)]</strong> — Nominal power, line-to-line voltage, and frequency<br>[1.5e6/0.9, 575, 60] (default)</td><td>Nominal power in VA, the nominal line-to-line voltage in Vrms and the nominal system frequency in hertz.</td></tr><tr><td><strong>Stator [Rs, Lls] (pu)</strong> — Stator resistance Rs and leakage inductance Lls<br>[ 0.004843, 0.1248] (default)</td><td>Stator resistance Rs and leakage inductance Lls in pu based on the generator ratings.</td></tr><tr><td><strong>Rotor [Rr', Llr'] (pu)</strong> — Rotor resistance Rr' and leakage inductance Llr'<br>[ 0.004377, 0.1791] (default)</td><td>Rotor resistance Rr' and leakage inductance Llr', both referred to the stator, in pu based on the generator ratings.</td></tr><tr><td><strong>Magnetizing inductance Lm (pu)</strong> — Magnetizing inductance Lm<br>6.77 (default)</td><td>Magnetizing inductance Lm in pu based on the generator ratings.</td></tr><tr><td><strong>Inert constant, friction factor, and pairs of poles [H(s), F(pu), p]</strong> — Inert constant, friction factor, and pairs of poles<br>[5.04, 0.01, 3] (default)</td><td><p>Combined generator and turbine inertia constant H in seconds, combined viscous friction factor F in pu based on the generator ratings and number of pole pairs p.</p><p>You may need to use your own turbine model, in order for example, to implement different power characteristics or to implement the shaft stiffness.</p><p>Your model must then output the mechanical torque applied to the generator shaft.</p><p>If the inertia and the friction factor of the turbine are implemented inside the turbine model you specify only the generator inertia constant H and the generator friction factor F.</p></td></tr><tr><td><strong>Initial conditions [s, th(deg), ias, ibs, ics (pu), ph_as, ph_bs, ph_cs (pu)]</strong> — Initial slip, electrical angle, stator current magnitude, and phase angle<br>[-0.01,0, 0,0,0, 0,0,0] (default)</td><td>Initial slip s, electrical angle Θ in degrees, stator current magnitude in pu, and phase angle in degrees.</td></tr></tbody></table>

### Turbine

This tab is not visible when you select the **External turbine (Tm mechanical torque input)** parameter.

<table data-header-hidden><thead><tr><th width="249.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Pitch angle beta used to display characteristics (beta >= 0)</strong> — Pitch angle used to display the wind turbine power characteristics<br>0 (default)</td><td>Pitch angle used to display the wind turbine power characteristics.<strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</td></tr><tr><td><strong>Nominal wind turbine mechanical output power (W)</strong> — Nominal turbine mechanical output power<br>1.5e6 (default)</td><td>Nominal turbine mechanical output power in watts.<strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</td></tr><tr><td><strong>Base wind speed (m/s)</strong> — Base value of wind speed<br>9 (default)</td><td><p>Base value of the wind speed, in m/s, used in the per unit system. The base wind speed is the mean value of the expected wind speed. This base wind speed produces a mechanical power which is usually lower than the turbine nominal power.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Base rotational speed (pu of base generator speed)</strong> — Rotational speed at maximum power for base wind speed<br>1 (default)</td><td><p>Rotational speed at maximum power for the base wind speed.</p><p>The base rotational speed is in pu of the base generator speed.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Maximum power at base wind speed (pu of nominal mechanical power)</strong> — Maximum power at base wind speed of nominal mechanical power<br>1 (default)</td><td><p>Maximum power at base wind speed in pu of the nominal mechanical power.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Pitch angle controller gain [Kp Ki]</strong> — Proportional and Integral gains of pitch controller<br>[5 25] (default)</td><td><p>Proportional and Integral gains Kp and Ki of the pitch controller.</p><p>Specify Kp in degrees/(power deviation pu) and Ki in degrees/(power deviation pu)/s.</p><p>The power deviation is the difference between actual electrical output power and the nominal mechanical power in pu of the generator nominal power.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Maximum pitch angle (deg)</strong> — Maximum pitch angle<br>45 (default)</td><td><p>Maximum pitch angle in degrees.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Maximum rate of change of pitch angle (deg/s)</strong> — Maximum rate of change of pitch angle<br>2 (default)</td><td><p>Maximum rate of change of the pitch angle in degrees/s.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr><tr><td><strong>Display wind turbine power characteristics</strong> — Plot turbine power characteristics at specified pitch angle for different wind speeds<br></td><td><p>Click to plot the turbine power characteristics at the specified pitch angle for different wind speeds.</p><p><strong>Dependencies</strong> To enable this parameter, clear the <strong>External turbine (Tm mechanical torque input)</strong> parameter.</p></td></tr></tbody></table>

## Examples

See the [Wind Farm - Induction Generator](https://opal-rt.atlassian.net/wiki/spaces/PSPS/pages/1551833713/Wind+Farm+-+Induction+Generator) (power\_wind\_ig) example, which illustrates the steady-state and dynamic performance of the WTIG. Three WTIG blocks are used to simulate a 9-MW wind farm connected in a 25 kV, 60 Hz, system. Voltage regulation is performing by a 3-Mvar STATCOM.


---

# 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/renewables/wind-turbine-induction-generator-phasor-type.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.
