> 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/thyristor.md).

# Thyristor

## Description

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

The **Thyristor** block, located in the **OPAL-RT SPS Software/Power Electronics** library, is a semiconductor device that can be turned on via a gate signal.

The thyristor model is simulated as a resistor Ron, an inductor Lon, and a DC voltage source representing the forward voltage Vf, connected in series with a switch. The switch is controlled by a logical signal depending on the voltage Vak, the current Iak, and the gate signal g.

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

The Thyristor block also contains a series Rs-Cs snubber circuit that can be connected in parallel with the thyristor device.

The static VI characteristic of this model is shown below.

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

The thyristor device turns on when the anode-cathode Vak voltage is greater than Vf and a positive pulse signal is applied at the gate input (g > 0). The pulse height must be greater than 0 and last long enough to allow the thyristor anode current to become larger than the latching current Il.

The thyristor device turns off when the current flowing in the device becomes 0 (Iak = 0) and a negative voltage appears across the anode and cathode for at least a period of time equal to the turnoff time Tq. If the voltage across the device becomes positive within a period of time less than Tq, the device turns on automatically even if the gate signal is low (g = 0) and the anode current is less than the latching current. Furthermore, if during turn-on, the device current amplitude stays below the latching current level specified in the dialog box, the device turns off after the gate signal level becomes low (g = 0).

The turnoff time Tq represents the carrier recovery time: it is the time interval between the instant the anode current has decreased to 0 and the instant when the thyristor is capable of withstanding positive voltage Vak without turning on again.

## Ports

### Input

<table data-header-hidden><thead><tr><th width="253">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>g</strong> — Thyristor control signal (Simulink signal)</td><td>Simulink signal to control the opening and closing of the thyristor.</td></tr></tbody></table>

#### Output

<table data-header-hidden><thead><tr><th width="251.7999267578125">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>m</strong> — Switch output (Simulink signal)</td><td>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:<br>1- Thyristor current (A)<br>2- Thyristor voltage (V)<br><strong>Dependencies:</strong> To enable this port, select the <strong>Show measurement port</strong> parameter.</td></tr></tbody></table>

### Conserving

<table><thead><tr><th width="264.99993896484375">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>A</strong> — Thyristor anode (SPS electrical)</td><td>SPS electrical conserving port associated with the thyristor anode.</td></tr><tr><td><strong>k</strong> — Thyristor cathode (SPS electrical)</td><td>SPS electrical conserving port associated with the thyristor cathode.</td></tr></tbody></table>

## Parameters

To optimize simulation speed, two models of thyristors are available: the thyristor model and the detailed thyristor model. For the thyristor model, the latching current Il and recovery time Tq are assumed to be 0.

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><thead><tr><th width="261">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Resistance Ron</strong> — Internal resistance of the thyristor<br>0.001 | nonnegative scalar</td><td>Internal resistance of the thyristor, 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><strong>Inductance Lon</strong> — Internal inductance of thyristor<br>0 (default) | 1e-3 | nonnegative scalar</td><td>Internal inductance Lon, in henry (H). Default is 0 for Thyristor blocks and 1e–3 for Detailed Thyristor blocks. 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><strong>Forward voltage Vf</strong> — Forward voltage of thyristor<br>0.8 | nonnegative scalar</td><td>Forward voltage of the thyristor device, in volts.</td></tr><tr><td><strong>Initial current Ic</strong> — Initial current flowing in thyristor<br>0 | nonnegative scalar</td><td>Initial current flowing in the thyristor. It is usually set to 0 to start the simulation with the device blocked. You can specify an <strong>Initial current Ic</strong> value corresponding to a particular state of the circuit. In such a case all states of the linear circuit must be set accordingly. Initializing all states of a power electronic converter is a complex task. Therefore, this option is useful only with simple circuits. Dependencies: To enable this parameter, set <strong>Inductance Lon</strong> to a value greater than 0.</td></tr><tr><td><strong>Snubber resistance Rs</strong> — Snubber resistance<br>500 | nonnegative scalar</td><td>Snubber resistance, in ohms (Ω). Set the <strong>Snubber resistance Rs</strong> parameter to inf to eliminate the snubber from the model.</td></tr><tr><td><strong>Snubber capacitance Cs</strong> — Snubber capacitance<br>250e-9 | nonnegative scalar</td><td>Snubber capacitance in farads (F). 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><strong>Show measurement port</strong> — Option to show measurement port<br>on | off</td><td>If selected, add a Simulink output to the block returning the thyristor current and voltage.</td></tr><tr><td><strong>Latching current Il</strong> — Latching current<br>0.1 | nonnegative scalar</td><td>The latching current of the detailed thyristor model, in amperes (A). Default is 0.1. This parameter is specific to Detailed Thyristor blocks.</td></tr><tr><td><strong>Turn-off time Tq</strong><br>100e-6 | positive scalar</td><td>The turn-off time Tq of the detailed thyristor model, in seconds (s). Default is 100e–6. This parameter is specific to Detailed Thyristor blocks.</td></tr></tbody></table>

## Assumptions and Limitations

* The Thyristor block implements a macro model of the real thyristor. It does not take into account either the geometry of the device or complex physical processes that model the behavior of the device \[1, 2]. The forward breakover voltage and the critical value of the derivative of the reapplied anode-cathode voltage are not considered by the model.
* Depending on the value of the inductance Lon, the Thyristor block is modeled either as a current source (Lon > 0) or as a variable topology circuit (Lon = 0). The Thyristor 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

In the power\_thyristor example, a single-pulse thyristor rectifier is used to feed an RL load. The gate pulses are obtained from a pulse generator synchronized on the source voltage. The following parameters are used:

| R                     | 1 Ω     |
| --------------------- | ------- |
| L                     | 10 mH   |
| Thyristor block — Ron | 0.001 Ω |
| Thyristor block — Lon | 0 H     |
| Thyristor block — Vf  | 0.8 V   |
| Thyristor block — Rs  | 20 Ω    |
| Thyristor block — Cs  | 4e-6 F  |

The firing angle is varied by a pulse generator synchronized on the voltage source. Run the simulation and observe the load current and load voltage, as well as the thyristor current and voltage.

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

\[1] Rajagopalan, V., *Computer-Aided Analysis of Power Electronic Systems*, Marcel Dekker, Inc., New York, 1987.

\[2] 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/thyristor.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.
