> 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/artemis-library/3-level-npc-tsb-with-high-impedance-capability.md).

# 3-level NPC TSB with High Impedance Capability

## Description

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

The **3-level-NPC Time Stamped Bridge (TSB)** block, located in the **ARTEMiS/Tools/Custom Models** library, implements a 3‑level neutral-point-clamped bridge with high-impedance and free‑wheeling diode rectification modes. It models IGBT/GTO/MOSFET devices as ideal switches with anti-parallel diodes.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-692a1ff3c41c3fb2209a5a4c842b5f4ca82ba81b%2FArtemis_3level_NPC_TSB_HImpedance_capability_equiv.png?alt=media" alt=""><figcaption><p>Equivalent electrical circuit of the 3-Level-NPC TSB block with 3 arms.</p></figcaption></figure>

The model uses an average approach. In continuous conduction mode, each phase output voltage is set to V+, Vneutral, or V−, weighted by the conduction time ratio of the gate signal at each time step.

Additional operating modes:

* **High‑impedance mode**: When no pulses are present for the two middle IGBTs, the output enters high‑impedance at the next current zero crossing. In this mode, the output current decreases to 0 after a certain time.
* **Rectifying mode**: While in high‑impedance, if the load voltage becomes higher/lower than the DC‑link voltages, the model simulates rectification through the anti‑parallel diodes.

{% hint style="danger" %}
This block requires a valid RT-LAB license on the simulator with the feature ARTEMiS enabled. Refer to[ ARTEMiS Requirements](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/power-systems-with-artemis/artemis-requirements.md) for details.
{% 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-d4293b53b8911fd4600e37f09b4a4f38212139c1%2FArtemis_3level_NPC_TSB_HImpedance_capability_mask.png?alt=media" alt="" width="372"><figcaption></figcaption></figure>

<table><thead><tr><th width="250.79998779296875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Number of bridge arms</strong></td><td>Currently set to 3.</td></tr><tr><td><strong>Active Switch Ron (ohms)</strong></td><td>Internal resistance of the IGBT (or equivalent).</td></tr><tr><td><strong>Active Switch Forward Voltage (V)</strong></td><td>Internal forward voltage drop of the IGBT (or equivalent)</td></tr><tr><td><strong>Diode Ron (Ohms)</strong></td><td>Internal resistance of its anti-parallel diode, in ohms.</td></tr><tr><td><strong>Diode Forward Voltage (V)</strong></td><td>Internal forward voltage drop of its anti-parallel diode, in volts.</td></tr><tr><td><strong>High impedance resistance value (Ohms)</strong></td><td>Output resistance used when the inverter enters high‑impedance mode. This value cannot be arbitrarily high due to numerical stability constraints.</td></tr><tr><td><strong>Use High impedance capacitor</strong></td><td>When selected, an RC snubber is used to emulate the high‑impedance mode.</td></tr><tr><td><strong>High impedance capacitor value (F)</strong></td><td>Capacitance of the equivalent RC snubber used when the block enters high‑impedance mode (active only when “Use High impedance capacitor” is selected).</td></tr><tr><td><strong>DC link current Common Mode Removal</strong></td><td>Removes residual common‑mode in the DC‑link input currents. Because the model’s input and output are not algebraically linked (controlled sources), a small common‑mode residue may appear and affect accuracy. Enable this option to eliminate it, especially when the bridge is fed by a floating rectifier where the sum of input currents should be zero.</td></tr><tr><td><strong>Dead Time current Threshold (A)</strong></td><td>Minimum load current required to turn on anti‑parallel diodes when no IGBT pulses are present.</td></tr></tbody></table>

{% hint style="danger" %}
The DC voltage must be well defined; do not apply open faults at the DC‑link with this model.
{% endhint %}

## Conserving ports

<table><thead><tr><th width="250.79998779296875">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>A, B, C (SPS)</strong></td><td>Inverter phase output connections (A, B, C) for Simscape Electrical Specialized Power Systems (SPS).</td></tr><tr><td><strong>Vn_delay (SPS)</strong></td><td>Neutral connection for circuits tied to the inverter outputs (for example, an LC filter).<br>This node has the same delay as A, B, and C, which can be required for balanced delays. Use it, for instance, to connect a load‑filter current return to the neutral point.</td></tr><tr><td><strong>V+ (SPS)</strong></td><td>Positive DC‑link connection for Simscape Electrical Specialized Power Systems (SPS).</td></tr><tr><td><strong>Vn (SPS)</strong></td><td>Neutral DC‑link connection for Simscape Electrical Specialized Power Systems (SPS).</td></tr><tr><td><strong>V− (SPS)</strong></td><td>Negative DC‑link connection for Simscape Electrical Specialized Power Systems (SPS).</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="250">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>Gates (double) (size 12)</strong></td><td>Gate control signals. A value of 1 turns the switch ON, 0 turns it OFF, and values between 0 and 1 represent the conduction time ratio within the time step.</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="250.79998779296875">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>In_meas</strong></td><td>Measurement of the neutral input point current (current entering point N in the circuit). When a circuit is connected to Vn_delay, measuring current directly at Vn would include current through Vn_delay. Use In_meas to obtain the true input current at Vn.</td></tr></tbody></table>

## Characteristics and limitations

<table><thead><tr><th width="250.79998779296875">Characteristic</th><th>Value</th></tr></thead><tbody><tr><td>Direct feedthrough</td><td>No</td></tr><tr><td>Sample time</td><td>Inherited and fixed discrete.</td></tr><tr><td>Work offline</td><td>Yes</td></tr><tr><td>Dimensionalized</td><td>No</td></tr><tr><td>Fault types</td><td><p>The internal model allows certain faults. Fault impedance may be limited by numerical stability because the 3‑Level‑NPC TSB introduces a delay between the input and output.</p><ul><li>AC‑side open phase: Supported. Made internally in SPS.</li><li>AC‑side short‑circuit: Supported. Made internally in SPS.</li><li>Open DC‑link input: Not supported.</li><li>DC‑link short circuit: Supported. Made internally in SPS.</li><li>Internal IGBT open‑phase fault: Supported through IGBT gating signal.</li><li>Internal IGBT short‑circuit: Not supported.</li><li>Diode open‑circuit/short‑circuit: Not supported.</li></ul></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/artemis-library/3-level-npc-tsb-with-high-impedance-capability.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.
