> 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-fault.md).

# Three Phase Fault

## Description

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

The **Three Phase Fault** bloc&#x6B;**,** located in the **OPAL-RT SPS Software/Power Grid Elements** library, Implement programmable phase-to-phase and phase-to-ground fault breaker system

The Three-Phase Fault block uses three Breaker blocks that can be individually switched on and off to program phase-to-phase faults, phase-to-ground faults, or a combination of phase-to-phase and ground faults. The arc extinction process of the Three-Phase Fault block is the same as for the Breaker block. See the [Breaker](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/breakers-and-faults/breaker.md) block for details on the modeling of the single-phase breakers.

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

The ground resistance Rg is automatically set to 106 ohms when the ground fault option is not programmed. For example, to program a fault between the phases A and B you need to select the **Phase A** and **Phase B** block parameters only. To program a fault between the phase A and the ground, you need to select the **Phase A** and **Ground** parameters and specify a small value for the ground resistance.

If the Three-Phase Fault block is set in external control mode, a control input appears in the block icon. The control signal connected to the fourth 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 Fault block is set in internal control mode, the switching times and status are specified in the dialog box of the block.

Series Rs-Cs snubber circuits are included in the model. They can be optionally connected to the fault breakers. If the Three-Phase Fault block is 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="187.5999755859375"></th><th></th></tr></thead><tbody><tr><td><strong>com</strong> — Control input<br>Simulink signal</td><td>Control input for the three-phase fault.<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="190"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A terminal<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase A terminal.</td></tr><tr><td><strong>B</strong> — Phase B terminal<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase B terminal.</td></tr><tr><td><strong>C</strong> — Phase C terminal<br>Specialized electrical</td><td>Specialized electrical conserving port associated with the phase C terminal.</td></tr></tbody></table>

### Parameters

<table data-header-hidden><thead><tr><th width="210"></th><th></th></tr></thead><tbody><tr><td><strong>Initial status</strong> — Initial status of fault breaker<br>0 (default) | scalar</td><td>Initial status of the fault breaker. You can also start the simulation in steady state with the fault initially applied on the system.</td></tr><tr><td><strong>Phase A</strong> — Fault switching of phase A<br>on (default) | off</td><td>If selected, the fault switching of phase A is activated. If not selected, the breaker of phase A stays in the status specified in the <strong>Initial status</strong> parameter.</td></tr><tr><td><strong>Phase B</strong> — Fault switching of phase B<br>on (default) | off</td><td>If selected, the fault switching of phase B is activated. If not selected, the breaker of phase B stays in the status specified in the <strong>Initial status</strong> parameter.</td></tr><tr><td><strong>Phase C</strong> — Fault switching of phase C<br>on (default) | off</td><td>If selected, the fault switching of phase C is activated. If not selected, the breaker of phase C stays in the status specified in the <strong>Initial status</strong> parameter.</td></tr><tr><td><strong>Ground</strong> — Fault switching of phase C<br>on (default) | off</td><td>If selected, the fault switching of ground is activated. A fault to the ground can be programed for the activated phases. For example, if the <strong>Phase C</strong> and <strong>Ground</strong> parameters are selected, a fault to the ground is applied to the phase C. The ground resistance is set internally to <code>1e6</code> ohms when the <strong>Ground</strong> parameter is not selected.</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 block in internal control mode. At each transition time the selected fault breakers opens or closes depending to their initial state.<br><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 block for an external control of the switching times of the fault breakers. The switching times are defined by a Simulink signal (<code>0-1 sequence</code>).</td></tr><tr><td><strong>Fault resistances Ron</strong> — Internal resistance of phase fault breakers<br>0.001 (default) | positive scalar</td><td>Internal resistance, in ohms (Ω), of the phase fault breakers. This parameter cannot be set to <code>0</code>.</td></tr><tr><td><strong>Ground resistance Rg</strong> — Ground resistance<br>0.01 (default) | positive scalar</td><td>Ground resistance, in ohms (Ω). This parameter cannot be set to <code>0</code>.<br><strong>Dependencies</strong> To enable this parameter, select the <strong>Ground</strong> parameter.</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) | Fault voltages | Fault currents | Fault voltages and currents</td><td>Select Fault voltages to measure the voltage across the three internal fault breaker terminals. Select Fault 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 Fault voltages and currents to measure the breaker voltages and the breaker currents. Default is None. Place a Multimeter block in your model to display the selected measurements during the simulation. In the <strong>Available Measurements</strong> list box of the Multimeter block, the measurements are identified by a label followed by the block name and the phase:<br>Fault voltages - Ub &#x3C;block name> /Fault A:<br>Fault currents - Ib &#x3C;block name> /Fault 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-fault.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.
