> 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/basics/breakers-and-faults/three-phase-breaker.md).

# Three Phase Breaker

## Description

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

The **Three Phase Breaker** bloc&#x6B;**,** located in the **OPAL-RT SPS Software/Power Grid Elements** library, Implement three-phase circuit breaker opening at current zero crossing.

The Three-Phase Breaker block uses three Breaker blocks connected between the inputs and the outputs of the block. You can use this block in series with the three-phase element you want to switch. The arc extinction process of the Three-Phase Fault block is the same as for the Breaker block. See the Breaker block reference pages for details on the modeling of the single-phase breakers.

If the Three-Phase Breaker block is set in external control mode, a control input appears in the block icon. The control signal connected to the Simulink input must be either `0`, which opens the breakers, or any positive value, which closes the breakers. For clarity, a `1` signal is commonly used to close the breakers. If the Three-Phase Breaker block is set in internal control mode, the switching times are specified in the dialog box of the block. The three individual breakers are controlled with the same signal.

Series Rs-Cs snubber circuit are included in the model. They can be optionally connected to the three individual breakers. If the Three-Phase Breaker block happens to be in series with an inductive circuit, an open circuit or a current source, you must use the snubbers.

## Ports

### Input

<table data-header-hidden><thead><tr><th width="186.79998779296875"></th><th></th></tr></thead><tbody><tr><td><strong>com</strong> — Control input<br>Simulink signal</td><td>Control input for the breaker.<br><strong>Dependencies</strong> To enable this port, select the <strong>External</strong> parameter.</td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="278.800048828125"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A at input of breaker<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase A at the input of the breaker.</td></tr><tr><td><strong>B</strong> — Phase B at input of breaker<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase B at the input of the breaker.</td></tr><tr><td><strong>C</strong> — Phase C at input of breaker<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase C at the input of the breaker.</td></tr><tr><td><strong>a</strong> — Phase A at output of breaker<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase A at the output of the breaker.</td></tr><tr><td><strong>b</strong> — Phase B at output of breaker<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase B at the output of the breaker.</td></tr><tr><td><strong>c</strong> — Phase C at output of breaker<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase C at the output of the breaker.</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="220.39996337890625"></th><th></th></tr></thead><tbody><tr><td><strong>Initial status</strong> — Initial status of breakers<br>open (default) | closed</td><td>Initial status of the breakers. The initial status is the same for the three breakers. Depending on the initial status, the icon shows a closed contact or an open contact.</td></tr><tr><td><strong>Switching of: Phase A</strong> — Switching of phase A<br>on (default) | off</td><td>If selected, the switching of phase A is activated. If not selected, the breaker of phase A stays in its initial status specified in the <strong>Initial status</strong> parameter.</td></tr><tr><td><strong>Switching of: Phase B</strong> — Switching of phase B<br>on (default) | off</td><td>If selected, the switching of phase B is activated. If not selected, the breaker of phase B stays in its initial status specified in the <strong>Initial status</strong> parameter.</td></tr><tr><td><strong>Switching of: Phase C</strong> — Switching of phase C<br>on (default) | off</td><td>If selected, the switching of phase C is activated. If not selected, the breaker of phase C stays in its initial status specified in the <strong>Initial status</strong> parameter.</td></tr><tr><td><strong>Switching time (s)</strong> — Vector of switching times<br>[1/60 5/60] (default) | vector of scalars</td><td>Specify the vector of switching times when using the Three-Phase Breaker block in internal control mode. At each transition time the selected breakers opens or closes depending to their initial state.<strong>Dependencies</strong> To enable this parameter, clear the <strong>External</strong> parameter.</td></tr><tr><td><strong>External</strong> — Option to enable external control signal<br>off (default) | on</td><td>If selected, adds a fourth input port to the Three-Phase Breaker block for an external control of the switching times of the breakers. The switching times are defined by a Simulink signal (0-1 sequence).</td></tr><tr><td><strong>Breakers resistance Ron</strong> — Internal breaker resistance<br>0.01 (default) | positive scalar</td><td>Internal breaker resistance, in ohms (Ω). The <strong>Breaker resistance Ron</strong>parameter cannot be set to <code>0</code>.</td></tr><tr><td><strong>Snubbers resistance Rs</strong> — Snubber resistance<br>1e6 (default) | nonnegative scalar</td><td>Snubber resistance, in ohms (Ω). Set this parameter to inf to eliminate the snubbers from the model.</td></tr><tr><td><strong>Snubbers capacitance Cs</strong> — Snubber capacitance<br>inf (default) | nonnegative scalar</td><td>Snubber capacitance, in farads (F). Set this parameter to 0 to eliminate the snubbers, or to inf to get resistive snubbers.</td></tr><tr><td><strong>Measurements</strong> — Option for measurements<br>None (default) | Breaker voltages | Breaker currents | Breaker voltages and currents</td><td>Select Breaker voltages to measure the voltage across the three internal breaker terminals. Select Breaker currents to measure the current flowing through the three internal breakers. If the snubber devices are connected, the measured currents are the ones flowing through the breakers contacts only. Select Breaker voltages and currents to measure the breaker voltages and the breaker currents. Place a Multimeter block in your model to display the selected measurements during the simulation. In the** Available Measurements** list box of the Multimeter block, the measurements is identified by a label followed by the block name and the phase:<br>Breaker voltages - Ub &#x3C;block_name> /Breaker A:<br>Breaker currents - Ib &#x3C;block_name> /Breaker A:</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/smart-power-simulation-software-sps/blocks-functions-tools/basics/breakers-and-faults/three-phase-breaker.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.
