> 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/three-level-bridge.md).

# Three Level Bridge

## Description

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

The **Three Level Bridge** block, located in the **OPAL-RT SPS Software/Power Electronics** library, implements a three-level power converter that consists of one, two, or three arms of power switching devices. Each arm consists of four switching devices along with their antiparallel diodes and two neutral clamping diodes as shown 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-8052e9cf8fe46fd6b83d6ff085a585cc6deabbf5%2F3level_bridge_model.png?alt=media" alt=""><figcaption></figcaption></figure>

The type of power switching device (IGBT, GTO, MOSFET, or ideal switch) and the number of arms (one, two, or three) are selectable from the dialog box. When the ideal switch is used as the switching device, the Three-Level Bridge block implements an ideal switch bridge having a three-level topology as shown in the following figure.

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

## Ports

### Input

<table data-header-hidden><thead><tr><th width="212.4000244140625"></th><th></th></tr></thead><tbody><tr><td><strong>g</strong> — Gating signal to control converter<br>Vector of 4, 8, or 12 elements</td><td><p>Vectorized gating signal containing pulses to control the power electronic devices of the bridge. The length of the input vector depends on the number of arm you specified for the bridge topology.</p><p>Depending of the number of bridge arms, pulse vector input g is :<br>1 - [Q1a,Q2a,Q3a,Q4a]<br>2 - [Q1a,Q2a,Q3a,Q4a,Q1b,Q2b,Q3b,Q4b]<br>3 - [Q1a,Q2a,Q3a,Q4a,Q1b,Q2b,Q3b,Q4b,Q1c,Q2c,Q3c,Q4c]</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>In the case of the ideal switch converter, the Q1 pulse is sent to Sw1, the Q4 pulse to Sw2, and a logical AND operation is performed on the Q2 and Q3 pulses and the result sent to Sw3.</p></div></td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="223.7999267578125"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A terminal SPS electrical</td><td>SPS electrical conserving port associated with the phase A terminal.</td></tr><tr><td><strong>B</strong> — Phase B terminal SPS electrical</td><td>SPS electrical conserving port associated with the phase B terminal.</td></tr><tr><td><strong>C</strong> — Phase C terminal SPS electrical</td><td>SPS electrical conserving port associated with the phase C terminal.</td></tr><tr><td><strong>N</strong> — Neutral terminal SPS electrical</td><td>SPS electrical conserving port associated with the neutral terminal.</td></tr><tr><td><strong>+</strong> — Positive terminal SPS electrical</td><td>SPS electrical conserving port associated with the positive terminal.</td></tr><tr><td><strong>-</strong> — Negative terminal SPS electrical</td><td>SPS electrical conserving port associated with the negative terminal.</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="230.79998779296875"></th><th></th></tr></thead><tbody><tr><td><strong>Number of bridge arms</strong> — Number of bridge arms3 (default) | 1 | 2</td><td>Number of bridge arms.</td></tr><tr><td><strong>Snubber resistance Rs</strong> — Snubber resistance1e5 (default) | positive scalar</td><td>Snubber resistance, in ohms. Set the snubber resistance to inf to eliminate the snubbers.</td></tr><tr><td><strong>Snubber capacitance Cs</strong> — Snubber capacitanceinf (default) | nonnegative scalar</td><td>Snubber capacitance, in farads. Set the <strong>Snubber capacitance Cs (F)</strong> parameter to 0 to eliminate the snubbers, or to inf to get a resistive snubber. To eliminate snubbers in all power electronic devices when using a continuous solver, select the <strong>Disable snubbers in switching devices</strong> option in the Powergui <strong>Preferences</strong> tab. When your system is discretized, you can simulate power electronic devices with virtually no snubbers by specifying purely resistive snubbers with a very large resistance, thus producing negligible leakage currents. The bridge operates satisfactorily with purely resistive snubbers.</td></tr><tr><td><strong>Power electronic device</strong> — Type of power electronic deviceGTO / Diodes (default) | MOSFET / Diodes | IGBT / Diodes | Ideal Switches</td><td>Type of power electronic device to use in the bridge</td></tr><tr><td><strong>Internal resistance Ron</strong> — Internal resistance1e-3 (default) | nonnegative scalar</td><td>Internal resistance of the selected devices and diodes, in ohms (Ω).</td></tr><tr><td><strong>Forward voltages [Device Vf, Diode Vfd]</strong> — Forward voltage across diode[ 0 0 ] (default) | vector of two nonnegative values</td><td>Forward voltage of the selected devices (for GTO or IGBT only) and of the anti-parallel and clamping diodes, in volts #### Dependencies To enable this parameter, set <strong>Power electronic device</strong> to GTO/Diodes or IGBT / Diodes.</td></tr><tr><td><strong>Measurements</strong> — Measurement typeNone (default) | All device currents | Phase-to-Neutral and DC voltages | All voltages and currents</td><td>Select All device currents to measure the current flowing through all the components (switching devices and diodes). If the snubber devices are defined, the measured currents are those flowing through the power electronic devices only. Select Phase-to-Neutral and DC voltages to measure the terminal voltages (AC and DC) of the Three-Level Bridge block. Select All voltages and currents to measure all voltages and currents defined for the Three-Level Bridge block. Place a Multimeter block in your model to display the selected measurements during the simulation.</td></tr></tbody></table>

In the **Available Measurement** list box of the Multimeter block, the measurement is identified by a label followed by the block name.

| **Measurement**   | **Label (for GTO, IGBT, MOSFET Devices)**                                                                                                                                                                               |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Device currents   | <p>IQ1a, IQ2a, IQ3a, IQ4a,</p><p>IQ1b, IQ2b, IQ3b, IQ4b,</p><p>IQ1c, IQ2c, IQ3c, IQ4c,</p><p>ID1a, ID2a, ID3a, ID4a, ID5a, ID6a,</p><p>ID1b, ID2b, ID3b, ID4b, ID5b, ID6b,</p><p>ID1c, ID2c, ID3c, ID4c, ID5c, ID6c</p> |
| Terminal voltages | Uan:, Ubn:, Ucn:, Udc+:, Udc-:                                                                                                                                                                                          |

| **Measurement**   | **Label (for Ideal Switch Device)**                                        |
| ----------------- | -------------------------------------------------------------------------- |
| Device currents   | <p>Isw1a, Isw2a, Isw3a, Isw1b, Isw2b, Isw3b,</p><p>Isw1c, Isw2c, Isw3c</p> |
| Terminal voltages | Uan:, Ubn:, Ucn:, Udc+:, Udc-:                                             |

## Assumptions and Limitations <a href="#assumptions-and-limitations" id="assumptions-and-limitations"></a>

Turn-on and turn-off times (Fall time, Tail time) of power switching devices are not modeled in the Three-Level Bridge block.

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

The [AC/DC Three-Level PWM Converter](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/power-converters/ac-dc-three-level-pwm-converter.md) (power\_3levelVSC) example illustrates the use of the Three-Level Bridge block.


---

# 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/three-level-bridge.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.
