> 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/power-converters/switches/igbt.md).

# IGBT

## Description

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

The **IGBT** bloc&#x6B;**,** located in the **OPAL-RT SPS Software/Power Electronics** library, implements a semiconductor device controllable by the gate signal.

The IGBT is simulated as a series combination of a resistor Ron, inductor Lon, and a DC voltage source Vf in series with a switch controlled by a logical signal (g > 0 or g = 0).

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

The IGBT turns on when the collector-emitter voltage is positive and greater than Vf and a positive signal is applied at the gate input (g > 0). It turns off when the collector-emitter voltage is positive and a 0 signal is applied at the gate input (g = 0).

The IGBT device is in the off state when the collector-emitter voltage is negative. Note that many commercial IGBTs do not have the reverse blocking capability. Therefore, they are usually used with an antiparallel diode.

The IGBT block contains a series Rs-Cs snubber circuit, which is connected in parallel with the IGBT device (between terminals C and E).

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

The turnoff characteristic of the IGBT model is approximated by two segments. When the gate signal falls to 0, the collector current decreases from Imax to 0.1 Imax during the fall time (Tf), and then from 0.1 Imax to 0 during the tail time (Tt).

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

## Ports

### Input

<table data-header-hidden><thead><tr><th width="241"></th><th></th></tr></thead><tbody><tr><td><p><strong>g</strong> — IGBT control signal</p><p>Simulink signal</p></td><td>Simulink signal to control the opening and closing of the IGBT.</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="254"></th><th></th></tr></thead><tbody><tr><td><p><strong>m</strong> — Switch output</p><p>Simulink signal</p></td><td><p>The Simulink output of the block is a vector containing two signals. You can demultiplex these signals by using the Bus Selector block provided in the Simulink library.</p><ul><li>Signal 1: IGBT current — A</li><li>Signal 2: IGBT voltage — V</li></ul></td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="262"></th><th></th></tr></thead><tbody><tr><td><p><strong>C</strong> — IGBT collector</p><p>Specialized electrical</p></td><td>Specialized electrical conserving port associated with the IGBT collector.</td></tr><tr><td><p><strong>E</strong> — IGBT emitter</p><p>Specialized electrical</p></td><td>Specialized electrical conserving port associated with the IGBT emitter.</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.

<table data-header-hidden><thead><tr><th width="285"></th><th></th></tr></thead><tbody><tr><td><p><strong>Resistance Ron</strong> — Internal resistance of IGBT</p><p>0.001 (default) | nonnegative scalar</p></td><td>Internal resistance of the switch device, in ohms (Ω). The <strong>Resistance Ron</strong> parameter cannot be set to <code>0</code> when the <strong>Inductance Lon</strong> parameter is set to 0.</td></tr><tr><td><p><strong>Inductance Lon</strong> — Internal inductance of IGBT</p><p>0 (default) | nonnegative scalar</p></td><td>Internal inductance Lon, in henry (H). The <strong>Inductance Lon</strong> parameter is normally set to 0 except when the <strong>Resistance Ron</strong> parameter is set to 0.</td></tr><tr><td><p><strong>Forward voltage Vf</strong> — Forward voltage of IGBT</p><p>1 (default) | nonnegative scalar</p></td><td>Forward voltage of the IGBT device, in volts.</td></tr><tr><td><p><strong>Initial current Ic</strong> — Initial current flowing in IGBT</p><p>0 (default) | nonnegative scalar</p></td><td><p>Initial current flowing in the IGBT. It is usually set to <code>0</code> to start the simulation with the device blocked.</p><p>If the <strong>Initial current Ic</strong> parameter is set to a value greater than <code>0</code>, the steady-state calculation considers the initial status of the IGBT as closed. Initializing all states of a power electronic converter is a complex task. Therefore, this option is useful only with simple circuits.</p></td></tr><tr><td><p><strong>Snubber resistance Rs</strong> — Snubber resistance</p><p>1e5 (default) | nonnegative scalar</p></td><td>Snubber resistance, in ohms (Ω). Default is 1e5. Set the <strong>Snubber resistance Rs</strong> parameter to inf to eliminate the snubber from the model.</td></tr><tr><td><p><strong>Snubber capacitance Cs</strong> — Snubber capacitance</p><p>inf (default) | nonnegative scalar</p></td><td>Snubber capacitance in farads (F). Default is inf. Set the <strong>Snubber capacitance Cs</strong> parameter to 0 to eliminate the snubber, or to inf to get a resistive snubber.</td></tr><tr><td><p><strong>Show measurement port</strong> — Option to show measurement port</p><p>on (default) | off</p></td><td>If selected, add a Simulink output to the block returning the IGBT current and voltage.</td></tr></tbody></table>

## Assumptions and Limitations

The IGBT block implements a macro model of the real IGBT device. It does not take into account either the geometry of the device or the complex physical processes \[1].

Depending on the value of the inductance Lon, the IGBT is modeled either as a current source (Lon > 0) or as a variable topology circuit (Lon = 0). The IGBT block cannot be connected in series with an inductor, a current source, or an open circuit, unless its snubber circuit is in use.

The inductance Lon is forced to 0 if you choose to discretize your circuit.

## Examples

The power\_igbtconv example illustrates the use of the IGBT block in a boost DC-DC converter. The IGBT is switched on and off at a frequency of 10 kHz to transfer energy from the DC source to the load (RC). The average output voltage (VR) is a function of the duty cycle (α) of the IGBT switch:

$$
V\_R=\frac{1}{1-\alpha}V\_{dc}
$$

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

\[1] Mohan, N., T.M. Undeland, and W\.P. Robbins, *Power Electronics: Converters, Applications, and Design*, John Wiley & Sons, Inc., New York, 1995.


---

# 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/power-converters/switches/igbt.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.
