> 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/rt-lab/simulink-blocks-reference/microgrid-testbed-library/type-3-wind-turbine.md).

# Type 3 Wind Turbine

## Description

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-bd04f20404b374b79c8bd0649c232090c8fba74b%2FMG_type3wind_turbine_block.png?alt=media" alt="" width="197"><figcaption></figcaption></figure>

The **Type-3 Wind Turbine Generation System (WTGS)** block, located in the **microGrid Testbed/DER** library, models a pitch-regulated wind turbine using a doubly-fed induction generator (DFIG). The DFIG has stator windings directly connected to the external AC bus, while the rotor connects to the grid through a rotor-side converter (RSC) and a grid-side converter (GSC) that share a common DC link capacitor to regulate voltage.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-4e1fec2473340985ea4d8c5e6f47457ed34c1c32%2FMG_type3wind_turbine_diagram.png?alt=media" alt=""><figcaption><p>Basic structure of the Type-3 WTGS</p></figcaption></figure>

{% hint style="danger" %}
This block requires a valid RT-LAB license on both the workstation and the simulator, with the OP1420 feature enabled. For more information, see [Microgrid Control & DERs](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/power-systems-with-artemis/microgrid-control-and-ders.md).
{% endhint %}

## Mask parameters

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-3a868bed42bb2ce60b46419bc576dc74cb98858f%2FMG_type3wind_turbine_mask.jpg?alt=media" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="General" %}

<table><thead><tr><th width="250">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Sampling time</strong></td><td>Simulation time-step (s)</td></tr><tr><td><strong>Nominal frequency</strong></td><td>Fundamental network frequency (Hz)</td></tr><tr><td><strong>Total wind turbine nominal power</strong></td><td>Power rating of the wind turbine (VA)</td></tr><tr><td><strong>Nominal global power</strong></td><td>Overall installed capacity of the microgrid network (W)</td></tr></tbody></table>
{% endtab %}

{% tab title="Generator" %}

<table><thead><tr><th width="240.99993896484375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Nominal electrical power</strong></td><td>Apparent power rating of the asynchronous machine (VA)</td></tr><tr><td><strong>Mutual reactance</strong></td><td>Magnetizing reactance of the asynchronous machine (pu)</td></tr><tr><td><strong>Stator | Nominal voltage</strong></td><td>Stator line-to-line RMS voltage (generator terminal voltage) (V)</td></tr><tr><td><strong>Stator | Resistance</strong></td><td>Stator winding resistance of the asynchronous machine (pu)</td></tr><tr><td><strong>Stator | Reactance</strong></td><td>Stator winding leakage reactance of the asynchronous machine (pu)</td></tr><tr><td><strong>Rotor | Nominal voltage</strong></td><td>Rotor line-to-line RMS voltage (V)</td></tr><tr><td><strong>Rotor | Resistance</strong></td><td>Rotor winding resistance of the asynchronous machine (pu)</td></tr><tr><td><strong>Rotor | Reactance</strong></td><td>Rotor winding leakage reactance of the asynchronous machine (pu)</td></tr><tr><td><strong>Mechanical Properties | Inertia constant</strong></td><td>Combined rotor and load inertia constant (s)</td></tr><tr><td><strong>Mechanical Properties | Friction factor</strong></td><td>Combined rotor and load viscous friction coefficient (pu)</td></tr><tr><td><strong>Mechanical Properties | Number of pole-pairs</strong></td><td>Number of pole pairs</td></tr><tr><td><strong>Initial Conditions | Slip</strong></td><td>Initial slip of the asynchronous machine</td></tr><tr><td><strong>Initial Conditions | Electrical angle</strong></td><td>Initial electrical angle at t = 0 (deg)</td></tr><tr><td><strong>Initial Conditions | Magnitude</strong></td><td>Initial magnitude of the stator current (pu)</td></tr><tr><td><strong>Initial Conditions | Angle</strong></td><td>Initial angle of the stator current (deg)</td></tr></tbody></table>
{% endtab %}

{% tab title="Converter" %}

<table><thead><tr><th width="240.199951171875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Line filter capacitor (Q=50)</strong></td><td>Reactive power generated by the line filter at nominal voltage (VAR)</td></tr><tr><td><strong>Choke | Inductor</strong></td><td>Reactance of the choke (pu)</td></tr><tr><td><strong>Choke | Resistor</strong></td><td>Resistance of the choke (pu)</td></tr><tr><td><strong>DC Link | Capacitance per generator</strong></td><td>Capacitance of the DC link per generator (F)</td></tr><tr><td><strong>DC Link | Nominal DC bus voltage</strong></td><td>DC link nominal voltage (V)</td></tr></tbody></table>
{% endtab %}

{% tab title="Control" %}

<table><thead><tr><th width="261">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Cut-off frequency</strong></td><td>Cut-off frequency of the low-pass filter (Hz)</td></tr><tr><td><strong>Damping factor</strong></td><td>Damping factor of the low-pass filter</td></tr><tr><td><strong>Minimum speed</strong></td><td>Minimum angular shaft speed (pu)</td></tr><tr><td><strong>Maximum speed</strong></td><td>Maximum angular shaft speed (pu).</td></tr><tr><td><strong>Proportional gain (Kp)</strong></td><td>PI proportional gain for the torque controller (Speed Regulator).</td></tr><tr><td><strong>Integral gain (Ki)</strong></td><td>PI integral gain for the torque controller (Speed Regulator).</td></tr><tr><td><strong>Maximum speed output</strong></td><td>Maximum speed regulator output (pu).</td></tr><tr><td><strong>Turbine inertia</strong></td><td>Inertia of the turbine (s)</td></tr><tr><td><strong>Proportional gain (Kp)</strong></td><td>PI proportional gain for the pitch controller (Pitch Control).</td></tr><tr><td><strong>Maximum pitch angle</strong></td><td>Maximum pitch angle of the turbine (deg)</td></tr><tr><td><strong>Maximum rate of change of pitch angle</strong></td><td>Slew rate of the change of pitch angle (deg/s)</td></tr><tr><td><strong>Pitch time constant</strong></td><td>Time constant of the pitch control (s)</td></tr><tr><td><strong>Proportional gain (Kp)</strong></td><td>PI proportional gain for the pitch compensation (Pitch Compensation).</td></tr><tr><td><strong>Integral gain (Ki)</strong></td><td>PI integral gain for the pitch compensation (Pitch Compensation).</td></tr><tr><td><strong>Grid-side converter maximum current</strong></td><td>Maximum allowed DC current (pu).</td></tr><tr><td><strong>DC Bus Voltage Regulator | Proportional gain (Kp)</strong></td><td>PI proportional gain for the DC voltage regulation controller.</td></tr><tr><td><strong>DC Bus Voltage Regulator | Integral gain (Ki)</strong></td><td>PI integral gain for the DC voltage regulation controller.</td></tr><tr><td><strong>Current Regulator | Proportional gain (Kp)</strong></td><td>PI proportional gain for the current regulator (Grid-Side Controller).</td></tr><tr><td><strong>Current Regulator | Integral gain (Ki)</strong></td><td>PI integral gain for the current regulator (Grid-Side Controller).</td></tr><tr><td><strong>Current Regulator | Current limit</strong></td><td>Maximum regulator current (Grid-Side Controller) (pu).</td></tr><tr><td><strong>Maximum modulation index</strong></td><td>Grid-side maximum modulation index.</td></tr><tr><td><strong>Frequency of the grid-side PWM carrier</strong></td><td>PWM carrier signal frequency (Grid-Side Controller) (Hz)</td></tr><tr><td><strong>Minimum flux magnitude</strong></td><td>Minimum flux magnitude of the DFIG (Rotor-Side Converter) (pu).</td></tr><tr><td><strong>Maximum d-axis rotor current</strong></td><td>Maximum magnitude of the d-axis component of the rotor current (Rotor-Side Converter) (pu).</td></tr><tr><td><strong>Reactive Power Regulator | Integral gain (Ki)</strong></td><td>Integral gain for the reactive power controller (Rotor-Side Converter).</td></tr><tr><td><strong>Reactive Power Regulator | Minimum output value</strong></td><td>Minimum reactive power output (Rotor-Side Converter). (pu).</td></tr><tr><td><strong>Reactive Power Regulator | Maximum output value</strong></td><td>Maximum reactive power output (Rotor-Side Converter). (pu).</td></tr><tr><td><strong>Voltage Regulator | Integral gain (Ki)</strong></td><td>Integral gain for the voltage regulator controller (Rotor-Side Converter).</td></tr><tr><td><strong>Current Regulator | Proportional gain (Kp)</strong></td><td>PI proportional gain for the current regulator (Rotor-Side Converter).</td></tr><tr><td><strong>Current Regulator | Integral gain (Ki)</strong></td><td>PI integral gain for the current regulator (Rotor-Side Converter).</td></tr><tr><td><strong>Current Regulator | Current limit</strong></td><td>Maximum regulator current (Rotor-Side Converter) (pu).</td></tr><tr><td><strong>Maximum modulation index</strong></td><td>Rotor-side maximum modulation index.</td></tr><tr><td><strong>Frequency of the rotor-side PWM carrier</strong></td><td>PWM carrier signal frequency (Rotor-Side Converter) (Hz)</td></tr></tbody></table>
{% endtab %}

{% tab title="Turbine" %}

<table><thead><tr><th width="283.4000244140625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Nominal mechanical power output</strong></td><td>Net mechanical power transferred to the rotor (W)</td></tr><tr><td><strong>Coefficients [c1 … c8]</strong></td><td>Wind model equation coefficients</td></tr><tr><td><strong>Rated omega r</strong></td><td>Rated rotor (electrical) speed (pu)</td></tr><tr><td><strong>Cp max</strong></td><td>Maximum power efficiency (pu)</td></tr><tr><td><strong>Lambda at Cp max</strong></td><td>Lambda at maximum power efficiency</td></tr><tr><td><strong>Nominal wind speed</strong></td><td>Wind speed that gives maximum power efficiency (m/s)</td></tr><tr><td><strong>Initial wind speed</strong></td><td>Wind speed at the start of the simulation (m/s)</td></tr></tbody></table>
{% endtab %}

{% tab title="Drive Train" %}

<table><thead><tr><th width="270.60003662109375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Wind turbine inertia constant H</strong></td><td>Turbine inertia (s)</td></tr><tr><td><strong>Shaft spring constant refer to high-speed shaft</strong></td><td>Shaft spring constant as per-unit of the nominal mechanical torque (pu/rad)</td></tr><tr><td><strong>Shaft mutual damping</strong></td><td>Shaft mutual damping as per-unit of the nominal mechanical torque (1/pu)</td></tr><tr><td><strong>Turbine initial speed</strong></td><td>Turbine speed as per-unit of the nominal speed at the start of the simulation (pu)</td></tr><tr><td><strong>Initial output torque</strong></td><td>Torque output as per-unit of the nominal torque at the start of the simulation (pu)</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Inputs

<table><thead><tr><th width="230">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>P ref</strong></td><td>Active power reference (pu)</td></tr><tr><td><strong>Q ref</strong></td><td>Reactive power reference (pu)</td></tr><tr><td><strong>Wind speed ref</strong></td><td>Wind speed (m/s)</td></tr><tr><td><strong>Curtail enable</strong></td><td>Curtailment mode command<br>0 = not enabled, 1 = enabled</td></tr><tr><td><strong>Trip</strong></td><td>Grid connection command<br>0 = disconnected, 1 = connected</td></tr><tr><td><strong>V line</strong></td><td>Voltage measurement at the point of common coupling (V)</td></tr><tr><td><strong>I line</strong></td><td>Current measurement at the point of common coupling (A)</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="231.60003662109375">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>Measurements</strong></td><td>Bus containing several measurements.</td></tr><tr><td><strong>A</strong></td><td>Connection port to phase A of the grid.</td></tr><tr><td><strong>B</strong></td><td>Connection port to phase B of the grid.</td></tr><tr><td><strong>C</strong></td><td>Connection port to phase C of the grid.</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/rt-lab/simulink-blocks-reference/microgrid-testbed-library/type-3-wind-turbine.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.
