> 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/ssn-inverter-models.md).

# SSN Inverter Models

## Description

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

The **SSN Inverter** blocks, located in the **ARTEMiS/SSN/Inverters** library, implement power inverter and converter models optimized for real-time simulation. These blocks use the SSN nodal admittance approach with a delay-free compensation method for high-frequency switching events, similar to IVIC and TSB algorithms, but with key distinctions:

1. The compensation is **delay-free**—no delay occurs between the DC and AC sections.
2. The compensation is applied **locally** within the inverter’s SSN group.
3. The algorithm operates with the **ArtEvents** library and associated methods.

Supported topologies include **2-level inverters**, **3-level NPC inverters**, **3-level T-type inverters**, as well as **Buck** and **Boost converters**. Most blocks support **parallel operation** with firing pulse delays, as demonstrated in the Rockwell application.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-1ebb4597a31b5eddb0aaaaedaf42550350e5b867%2FArtemis_SSN_inveter_model_schem.png?alt=media" alt="" width="563"><figcaption><p>Rockwell paralleled 3-level NPC inverters</p></figcaption></figure>

Unlike ARTEMiS IVIC and TSB-RD inverter algorithms, SSN inverters contain **no binary switches**. Switching effects are entirely represented in the SSN nodal admittance matrix, eliminating the traditional switch count limitation per SSN group.

This architecture also improves real-time performance by reducing the numerical span of the solution—minimizing memory use and increasing cache efficiency on Intel processors used in OPAL-RT simulators.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-e9bfb805d3eea7797c5543446a748562e0fad1db%2FArtemis_SSN_inveter_model_time_curves.png?alt=media" alt="" width="563"><figcaption><p>Calculation times of each time step in RT-LAB for the Rockwell model</p></figcaption></figure>

Performance evaluations show that SSN inverters maintain consistent real-time performance without computation spikes. While TSB-RD models exhibit faster average computation times, they experience periodic spikes caused by cache misses during rectification events. SSN inverters, by contrast, achieve stable step times with lower peak computation delays.

| Inverter         | Stored Memory (Mb) | Estimated Mult-Add | Nodal Matrix Rank |
| ---------------- | ------------------ | ------------------ | ----------------- |
| **TSB-RD**       | {9.94, 10.46}      | {3200, 2600}       | {3 3}             |
| **SSN inverter** | {0.0902, 0.005488} | {1700, 1000}       | {8 11}            |

<p align="center"><em>Comparison of calculation characteristics of TSB-RD and SSN Inverters {rect, inv} values</em></p>

As shown above, SSN inverters significantly reduce memory requirements because they do not store state-space matrices. The larger admittance matrix slightly increases computational effort (O(n³) complexity) but remains compensated by reduced mult-add operations overall.

The Rockwell application model runs at a simulation time step of 50 microseconds. This time step is chosen for demonstration purposes; the model can run well below 10 μs as shown in Figure 1. The inverters are driven at 1.5 kHz and there is a 400 nanoseconds delay between the two inverters firing pulses. This delay caused a circulating current between the two inverters, something that industrial controller check before starting the drive.\
For the test, the induction motor goes from zero speed to nominal speed under load several times.\
Maximum motor current is about 3000 A but the inverter current difference is under 10 A.

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

This capability of considering a 400 nanoseconds difference in a simulation running at more than a 100\
time this sampling rate may look surprising but is possible with the events tracking and compensation\
methods used by SSN inverters and the ArtEvents blockset.

{% 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-acf7114c8ebb866ed22e32c2a3678c451913fd5d%2FArtemis_SSN_inveter_model_mask.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

<table data-search="false"><thead><tr><th width="239.60003662109375">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Ron (Ω)</strong></td><td>ON resistance of the main IGBT/GTO/MOSFET and anti-parallel diode.</td></tr><tr><td><strong>Roff (Ω)</strong></td><td>OFF resistance of the main IGBT/GTO/MOSFET and anti-parallel diode.</td></tr><tr><td><strong>Switch forward voltage drop (V)</strong></td><td>Forward voltage drop of the main IGBT/GTO/MOSFET and anti-parallel diode when conducting. Both components use the same value.</td></tr><tr><td><strong>Use RC snubber</strong></td><td>Enables two RC snubbers: one between Vup and Vo, and one between Vlo and Vo. No snubber exists between the neutral DC point and Vo in this version.</td></tr><tr><td><strong>Snubber Resistance (Ω)</strong></td><td>Resistance value of the snubber when enabled.</td></tr><tr><td><strong>Snubber Capacitance (F)</strong></td><td>Capacitance value of the snubber when enabled.</td></tr><tr><td><strong>Paralleled Inverters</strong></td><td>Number of inverters connected in parallel. When greater than one, connect the average current of all other inverters to the <strong>Iavg</strong> input.</td></tr></tbody></table>

{% hint style="info" %}
Verify that snubber parameters are consistent across all parallel inverter instances to prevent imbalanced behavior.
{% endhint %}

## Conservating ports

<table><thead><tr><th width="239.5999755859375">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>vup</strong></td><td>Positive DC rail of the inverter.</td></tr><tr><td><strong>vlo</strong></td><td>Negative DC rail of the inverter.</td></tr><tr><td><strong>vn</strong></td><td>Neutral DC rail (available for 3-level inverters only).</td></tr><tr><td><strong>A, B, C</strong></td><td>AC output phases of the inverter.</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="239.5999755859375">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>g</strong></td><td><p>Gate control inputs. Three formats are supported:</p><ul><li><strong>ArtEvents (AE)</strong>: up to 4 events per time step, directly connected to ArtEvents blocks.</li><li><strong>Mean Active Duty (MAD)</strong>: real value (0 ≤ x ≤ 1) indicating ON-state duty ratio for the current step, as used by TSB-RD.</li><li><strong>Digital (0–1)</strong>: discrete logical signal with no interpolation. In multiphase inverters, all gates for phase A appear before phase B, and so on.</li></ul></td></tr><tr><td><strong>Iavg</strong></td><td>Average current from other SSN inverters, used when multiple inverters operate in parallel.</td></tr></tbody></table>

{% hint style="info" %}
When operating multiple inverters in parallel, ensure all **Iavg** connections are properly linked to maintain synchronization.

Use **ArtEvents** to control gate inputs for accurate real-time switching representation.
{% endhint %}

## Outputs

<table><thead><tr><th width="240.4000244140625">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>meas</strong></td><td>Internal measurement signals, including nodal voltages and output currents.</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/ssn-inverter-models.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.
