> 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/courseware/electric-courseware/power-electronics/three-phase-three-level-neutral-point-clamped-converter/panels-overview.md).

# Panels Overview

## Understand the panel <a href="#id-3.1.-understanding-the-panels" id="id-3.1.-understanding-the-panels"></a>

The **Three-phase Three-level NPC** model file, located in the folder **OP1130 - Power Electronics Courseware,** is **PE\_ThreePhaseThreeLevelConverter-version.zip**

When starting the demo, the panel in Figure 10 below appears first with the default settings.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FNmnF1gl7FNLyLpWov1U5%2F2f5b35d1-4312-474a-8d62-644400259a73.png?alt=media&amp;token=a86490b2-6f86-486c-b282-6ddcc0cae1b7" alt=""><figcaption><p><strong>Figure 10:</strong> Start-Up Panel - Inverter Mode Scenario</p></figcaption></figure>

The panel is to be operated while following the three steps below:

{% stepper %}
{% step %}

### **Select scenario**

In the upper left corner, the student can select the scenario using the three tabs:

* Inverter Mode
* LC Filter
* Rectifier Mode
  {% endstep %}

{% step %}

### **Change parameters / Switch buttons**

In the lower left corner, the student can change the control parameters and can switch the control buttons (to enable/disable their associated functions) in the following categories:

* Scope Parameters
* Protection
* DC Source
* Inverter Parameters
* AC Source

Refer to the following tables for the control parameters, control buttons, and LED fuse status indicators.
{% endstep %}

{% step %}

### **Observe waveforms**

On the right side, the student can observe the waveforms displayed in four scopes.\
Additionally, the power flow, the fundamental voltage and total harmonic distortion (THD) for inverter and load are displayed.\
More details are given in Tables 5 and 6 in this page.
{% endstep %}
{% endstepper %}

### Control parameters

| Control Parameters                 | Default Value | Interval of Variation |
| ---------------------------------- | ------------- | --------------------- |
| **DC Source Vdc (V)**              | 120           | \[90; 160]            |
| **PWM Frequency (Hz)**             | 3000          | \[900; 3000]          |
| **Reference Amplitude/modulation** | 0.8           | \[0; 0.8]             |
| **AC-source Amplitude (V)**        | 70            | \[0; 100]             |
| **AC-source Frequency (Hz)**       | 60            | \[0; 60]              |
| **AC-source Phase Shift (Deg)**    | 0             | \[-90; 90]            |

{% hint style="info" %}
The “Save File” under Scope Parameters allows the student to give different file names for data acquisition, while the “Switch (50 Hz/60 Hz)” allows to select a reference frequency for power, THD and RMS computation.\
It is possible to save up to eleven .mat files with the name “FileSavedcurrents\_X (where X can be anywhere from 0 to 10).\
The student can give X values via the “Save File”, and press “Data Acq.” for acquiring data.\
The data acquired can be used for offline harmonic studies.

The saved data are in the following folder:\
*C:\OPAL-RT\TestDrive\v2.9.0.16\Models\Package4\_CPU\package4\_cpu\_sm\_master\OpNTtarget*
{% endhint %}

### **Control buttons and LED fuse status indicators**

<table data-search="false"><thead><tr><th width="180">Control Buttons</th><th width="135"></th><th>Associated functions</th></tr></thead><tbody><tr><td><strong>Trigger</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FY5bUKJE43vjfne5hC2Uy%2Fimage.png?alt=media&amp;token=68a4c261-1641-4f3c-a1c9-082c328ee280" alt="" data-size="original"></td><td><p>The waveforms are not triggered. They “move” </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FG7uCUqPgmqMKVXnqcTmG%2Fimage.png?alt=media&amp;token=36309465-f351-46d0-85b3-8336e7302811" alt="" data-size="original"></td><td><p>The waveforms are triggered with respect to a reference signal. </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td><strong>SYNCHRONIZE</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FmjdpSyi4O4VB16iYr2ms%2Fimage.png?alt=media&amp;token=6ca5f12b-7242-4b2b-8f1c-f5f79f12c8b3" alt="" data-size="original"></td><td><p>The reference frequency is fixed to 60 Hz (or 50 Hz). </p><p><em>This button is disabled in Rectifier Mode scenario</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FDbCBk4bZRwfSOyqKESWO%2Fimage.png?alt=media&amp;token=017d9284-f98c-4591-90ae-bbbcd059678b" alt="" data-size="original"></td><td><p>The reference frequency used for the PWM generator is dictated by the AC-source frequency. </p><p><em>This button is disabled in Rectifier Mode scenario</em></p></td></tr><tr><td><strong>Apply Deadtime</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FVMaDl4wa3CB1IkoKOnF5%2Fimage.png?alt=media&amp;token=38137795-dece-4363-89f5-965202be8142" alt="" data-size="original"></td><td><p>The dead-time is not applied in the control of the switches. </p><p><em>This button is disabled in Rectifier Mode scenario</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FbbsZbgemyc71ge2fxDiQ%2Fimage.png?alt=media&amp;token=caf26af0-ae88-4768-aff8-65f3fa564590" alt="" data-size="original"></td><td><p>The dead-time is applied in the control of the switches. </p><p><em>This button is disabled in Rectifier Mode scenario</em></p></td></tr><tr><td><strong>Connect Filter</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FMgS6RODhlV1fNSudzNad%2Fimage.png?alt=media&amp;token=af0d142d-b86b-48d6-a878-d16df6260d81" alt="" data-size="original"></td><td><p>The capacitors mounted in delta configuration are disconnected from the circuit. </p><p><em>This button is accessible in LC Filter and Rectifier Mode scenarios</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2Fs4BgNRcaXYXyJN1J2ZOt%2Fimage.png?alt=media&amp;token=e79f4773-b76d-4fe9-87b8-4c1a45451991" alt="" data-size="original"></td><td><p>The capacitors mounted in delta configuration are connected to the circuit, thus enabling the LC filter. </p><p><em>This button is accessible in LC Filter and Rectifier Mode scenarios</em></p></td></tr><tr><td><strong>PWM_DISABLE</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F1axHcHQCwmsr6p10HHEJ%2Fimage.png?alt=media&amp;token=18cc53ad-8713-40e8-b709-323d8d49c10b" alt="" data-size="original"></td><td><p>The PWM generator is enabled, and the commands are sent to the IGBTs. </p><p><em>This button is accessible in Rectifier Mode scenario only</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FjpdoXeuSHPuCLL4qLxpT%2Fimage.png?alt=media&amp;token=26d412be-1813-4e13-b847-17559945e1b7" alt="" data-size="original"></td><td><p>The PWM generator is disabled; the diodes are the sole conducting elements. </p><p><em>This button is accessible in Rectifier Mode scenario only</em></p></td></tr><tr><td><strong>APPLY_RECT_LOAD</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FU6sUEjXlPVRbvh2MgpiE%2Fimage.png?alt=media&amp;token=1cb36663-18ae-4b00-9e78-51069d5b8249" alt="" data-size="original"></td><td><p>The resistive load is disconnected at the output of the rectifier, on the DC side. </p><p><em>This button is accessible in Rectifier Mode scenario only</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FBNhFJkRLBE094ucp8tH3%2Fimage.png?alt=media&amp;token=a7cac08c-1213-4883-8efb-435f0b1e113b" alt="" data-size="original"></td><td><p>The resistive load is connected at the output of the rectifier, on the DC side. </p><p><em>This button is accessible in Rectifier Mode scenario only</em></p></td></tr><tr><td><strong>Data Acq.</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FV5WcDMbUsGvRXpK6QApK%2Fimage.png?alt=media&amp;token=f19bacf3-c906-471b-9721-7c92ad57e3e4" alt="" data-size="original"></td><td><p>Data acquisition is disabled. </p><p><em>This button is disabled in Rectifier Mode scenario</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FOTW7yBGhTjiOYAGJWS82%2Fimage.png?alt=media&amp;token=23d6df95-5f53-4e7c-972f-80547e0a3a7e" alt="" data-size="original"></td><td><p>Data acquisition is activated and allows to record .mat files for offline studies, in particular harmonic analysis. </p><p><em>This button is disabled in Rectifier Mode scenario</em></p></td></tr><tr><td><strong>Reset</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FLX6evrv7mEzIH9WRHVK8%2Fimage.png?alt=media&amp;token=44dd730d-2e53-4bdc-8a7b-7e2c8f240d44" alt="" data-size="original"></td><td><p>The reset push button is disabled. </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FLx3uwmwNWmQCepeVYFd6%2Fimage.png?alt=media&amp;token=b6e4ebcb-09dd-41af-a82d-842936b62ddb" alt="" data-size="original"></td><td><p>The reset push button is activated and simulates replacement of fuses after a fault. </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td><strong>HELP / BACK</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FYFm79i1ZZzfesMveEa48%2Fimage.png?alt=media&amp;token=10a07ea0-f478-4b71-9964-3084ec302b85" alt="" data-size="original"></td><td><p>Open the Help page associated to the scenario currently running. </p><p><em>This button is accessible and enabled in all scenarios</em></p></td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FJwJUuGkMex2i9kiZGi1p%2Fimage.png?alt=media&amp;token=4334f160-0b45-4039-bb46-cc19a318c78d" alt="" data-size="original"></td><td>Close the Help page and go back to the simulations. <em>This button is accessible and enabled in all scenarios</em></td></tr><tr><td><strong>Fuse</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FGZIPYUsAz34Bl9EuQJiA%2Fimage.png?alt=media&amp;token=8faf24af-f2a0-4bd5-81ad-9662821218de" alt="" data-size="original"></td><td>The protection fuse is blown.</td></tr><tr><td></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FLmLmhhXHzp4JxpzGdLrB%2Fimage.png?alt=media&amp;token=325e4181-43ed-4a57-affa-78ea0456ffcf" alt="" data-size="original"></td><td>The protection fuse is intact.</td></tr><tr><td><strong>Switch</strong></td><td><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2F6ReQZ0a25sc8DJXSgsFv%2Fimage.png?alt=media&amp;token=a34b8db6-781f-416e-a9ee-f94618a06c7f" alt="" data-size="original"></td><td>Reference frequency for PWM generation, 50 Hz or 60 Hz.</td></tr></tbody></table>

On scope localization, the indices used will be like those of matrix elements.\
Hence, the scope located in the upper left corner (first row, first column) is denoted Scope<sub>11</sub>, while the scope in the upper right corner (first row, second column) is Scope<sub>12</sub>.\
By the same token, the scope in the lower left corner is Scope<sub>21</sub> while the scope in the lower right corner is Scope<sub>22</sub>.

### Scopes and displayed waveforms

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FBv8uiX4JYi8doQ0bUgDJ%2F6d668bc0-9964-4fcb-885b-1b8bc1eda800.png?alt=media&amp;token=335d3e6a-142b-4d43-a3f9-e240218503a1" alt=""><figcaption></figcaption></figure>

Three power displays are available in all the scenarios. They are located below the scopes in the observation section. From left to right they are identified as Display<sub>1</sub>, Display<sub>2</sub> and Display<sub>3</sub>.

They refer to the power measurements described in the [Circuit Description](https://www.opal-rt.com/docs/courseware/electric-courseware/power-electronics/three-phase-three-level-neutral-point-clamped-converter/circuit-description.md) page.\
Additionally, two RMS voltage displays and two THD (related to inverter and load currents) displays, referred to as Display<sub>4</sub> to Display<sub>7</sub>, are located below the scopes of Inverter mode and LC Filter scenarios.

Finally, an extra display, referred to as Display<sub>8</sub>, is available for RMS filter current in the LC Filter scenario.

#### Display content

<table data-search="false"><thead><tr><th width="167">Scenario</th><th width="120">Display</th><th>Content of Displays</th></tr></thead><tbody><tr><td><strong>LC Filter</strong></td><td>Display<sub>1</sub></td><td>DC Power released by the DC source at the input of the inverter</td></tr><tr><td></td><td>Display<sub>2</sub></td><td>AC Power at the output of the inverter</td></tr><tr><td></td><td>Display<sub>3</sub></td><td>AC Power absorbed by the three-phase AC load</td></tr><tr><td></td><td>Display<sub>4</sub></td><td>RMS of fundamental inverter voltage (line-to-line)</td></tr><tr><td></td><td>Display<sub>5</sub></td><td>RMS of fundamental load voltage (line-to-line)</td></tr><tr><td></td><td>Display<sub>6</sub></td><td>THD of inverter current</td></tr><tr><td></td><td>Display<sub>7</sub></td><td>THD of load current</td></tr><tr><td></td><td>Display<sub>8</sub></td><td>RMS of fundamental filter current</td></tr><tr><td><strong>Rectifier Mode</strong></td><td>Display<sub>1</sub></td><td>AC Power released by the AC source</td></tr><tr><td></td><td>Display<sub>2</sub></td><td>AC Power at the input of the rectifier</td></tr><tr><td></td><td>Display<sub>3</sub></td><td>DC Power absorbed by the DC Load</td></tr></tbody></table>

Consequently, the power dissipated in the LC Filter and the converter bridge can be deduced as shown in the table below.

#### Power dissipated in LC filter and converter bridge

<table><thead><tr><th width="146">Scenario</th><th width="172">Difference</th><th>Description</th></tr></thead><tbody><tr><td><strong>LC Filter</strong></td><td>Display<sub>1</sub> - Display<sub>2</sub></td><td>Power dissipated in the inverter bridge (IGBT/Diodes)</td></tr><tr><td></td><td>Display<sub>2</sub> - Display<sub>3</sub></td><td>Power dissipated in the LC Filter</td></tr><tr><td><strong>Rectifier Mode</strong></td><td>Display<sub>1</sub> - Display<sub>2</sub></td><td>Power dissipated in the LC Filter</td></tr><tr><td></td><td>Display<sub>2</sub> - Display<sub>3</sub></td><td>Power dissipated in the rectifier bridge (diodes only)</td></tr></tbody></table>

## Scenario <a href="#id-3.2.-first-scenario-inverter-mode-with-load-r-l-back-emf" id="id-3.2.-first-scenario-inverter-mode-with-load-r-l-back-emf"></a>

### Inverter mode with Load R, L, Back-EMF <a href="#id-3.2.-first-scenario-inverter-mode-with-load-r-l-back-emf" id="id-3.2.-first-scenario-inverter-mode-with-load-r-l-back-emf"></a>

When starting the demo, the panel corresponding to the Inverter Mode scenario opens by default. A concise scheme of the circuit is given below the tabs in the scenario selection area.

More details on the circuit, the control parameters, and buttons, as well as the observed waveforms are available when clicking the Help button.\
The student can directly start exercises related to the Inverter Mode, available in [the next section](https://www.opal-rt.com/pages/sICsNf1RcAb6bUavvwY0#inlineextension-4.2.-inverter-mode).

### Adding LC Filter at the Inverter Output <a href="#id-3.3.-second-scenario-adding-lc-filter-at-the-inverter-output" id="id-3.3.-second-scenario-adding-lc-filter-at-the-inverter-output"></a>

When clicking on the “LC Filter” tab, the panel in Figure 11 below is displayed.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FupBbC3hAf7Bs1ykSMK3M%2Fa6bb96df-2ec7-48c0-af72-4bc9f4500156.png?alt=media&amp;token=3fee9726-2855-45c2-9bdb-a280b19adcbd" alt=""><figcaption><p><strong>Figure 11:</strong> Second Panel - LC Filter Scenario</p></figcaption></figure>

By clicking the **Connect Filter button**, the student activates the LC filtering and can start the [LC Filter Activated exercises](https://www.opal-rt.com/pages/sICsNf1RcAb6bUavvwY0#inlineextension-4.3.-lc-filter-activated) that are associated with this scenario.&#x20;

### Rectifier Mode <a href="#id-3.4.-third-scenario-rectifier-mode" id="id-3.4.-third-scenario-rectifier-mode"></a>

When clicking on the “Rectifier Mode” tab, the panel of Figure 12 below is displayed.

<figure><img src="https://4054096626-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYbyVjpgEQX9nfCkpYoFP%2Fuploads%2FqZB9YDXHdXbJYuOlwj47%2F0f304d45-9872-492d-bd4e-918df39d8641.png?alt=media&amp;token=e7a6d950-5697-4255-84ab-0260ae5a4730" alt=""><figcaption><p><strong>Figure 12:</strong> Third Panel - Rectifier Mode Scenario</p></figcaption></figure>

Note that by clicking the **PWM\_Disable button**, the DC Source is disconnected and the PWM generator is disabled.\
Consequently, the first category of control parameters, namely, “DC Source and PWM parameters” is automatically disabled.\
The same applies to the buttons **SYNCHRONIZE** and **Apply Deadtime**.


---

# 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/courseware/electric-courseware/power-electronics/three-phase-three-level-neutral-point-clamped-converter/panels-overview.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.
