> 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-faults-and-pow-synchronization-blocks-a-dedoubler.md).

# SSN Faults and POW Synchronization Blocks

## Description

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

The **POW fault blocks**, located in the **ARTEMiS/Tools/POW faults** library, are blocks used to conduct faults tests on ARTEMiS-SSN models.

* **OpElectricFault**\
  Implements an electrical fault using a standard SPS breaker. Unlike the SPS Breaker, it is selected through the **OpElectricFaultSelector** block and can be triggered at a specific point on the AC waveform (POW synchronization) when connected to **opPOWFaultControl**.
* **OpElectricFaultSelector**\
  Selects which ***OpElectricFault*****&#x20;block** to activate based on a user-defined **Location ID**. It can also set the fault type (e.g., three-phase, single-phase, line-to-line).
* **opPOWFaultControl**\
  Generates POW-synchronized trigger signals for ***OpElectricFault*****&#x20;blocks**, as well as acquisition triggers for OpWriteFile blocks. It can also produce time-varying fault triggers for statistical event testing.
* **opPOWEventControl**\
  Generates Point-On-Wave (POW)–synchronized trigger signals for ***OpElectricEvent*****&#x20;blocks**. It also provides acquisition triggers for OpWriteFile blocks. The block can create time-varying POW event signals for statistical testing.
* **OpElectricEventSelector**\
  Selects which ***OpElectricEvent*****&#x20;block** to activate based on a user-defined **Location ID**. It can also set the event type (three-phase, single-phase, line-to-line, etc.).
* **OpElectricEvent**\
  Implements an electrical event using an isolator, configurable as a standard SPS breaker or an ideal switch. Unlike the standalone breaker or switch, it can be triggered at a specific point on the AC waveform (POW synchronization) when connected to **opPOWEventControl**.

Please study the following ARTEMiS-SSN demos to quickly master how to use these blocks:

* ssn\_distributiongrid\_A1.mdl
* ssn\_distributiongrid\_A2.mdl

{% hint style="danger" %}
These blocks require 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

### OpPOWFaultControl <a href="#oppowfaultcontrol" id="oppowfaultcontrol"></a>

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

| Parameter                                           | Description                                                               |
| --------------------------------------------------- | ------------------------------------------------------------------------- |
| **Sample time (s)**                                 | Sample time used by the block.                                            |
| **PLL settings: Nominal Frequency of Network (Hz)** | Nominal network frequency for PLL operation.                              |
| **PLL settings: PLL regulator gains: Kp Ki Kd**     | Proportional, integral, and derivative gains of the PLL.                  |
| **Acquisition: Synchronization phase**              | Select phase A, B, or C for trigger generation.                           |
| **Acquisition: Detection mode**                     | Select rising zero-crossing or falling zero-crossing on the chosen phase. |

{% hint style="info" %}
PLL synchronization is not required if the **OpPOWFaultControl** block is connected to a strong voltage bus.
{% endhint %}

### OpElectricFaultSelector <a href="#opelectricfaultselector" id="opelectricfaultselector"></a>

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

<table data-search="false"><thead><tr><th>Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Fault type</strong></td><td>Use the check boxes to configure the fault type.</td></tr><tr><td><strong>Fault and acquisition period [s]</strong></td><td>Acquisition period for the fault events.</td></tr><tr><td><strong>'Fault start time': [Tst, Tst_var, Tst_pd]</strong></td><td>Tst: Fault start time in seconds, relative to the Fault and acquisition period.<br>Tst_var: Fault time variation span. At each acquisition period, the fault timing varies from Tst to Tst+Tst_var (if Tst_var == 0, the fault always starts at Tst).<br>Tst_pd: Fault variation cycle in seconds (applies if Tst_var is not zero).</td></tr><tr><td><strong>Enable Point-On-Wave</strong></td><td>If selected, adjusts the fault start time to occur precisely at a specified angle of the grid voltage source. Note: This option bypasses the 'Fault start time' parameters.</td></tr><tr><td><strong>Fault start angle [deg_st (deg), deg_var (deg), deg_pd (s)]</strong></td><td>deg_st: Source angle at the time of fault application (degrees).<br>deg_var: POW variation amplitude of the fault application (degrees).<br>deg_pd: Period of the POW variation (seconds).</td></tr><tr><td><strong>Fault duration [Tst, Tst_var, Tst_pd]</strong></td><td>Tst: Fault duration (seconds).<br>Tst_var: Fault duration varies from Tst to Tst+Tst_var (if Tst_var == 0, the duration is constant).<br>Tst_pd: Fault duration variation cycle (seconds).</td></tr><tr><td><strong>Fault location ID</strong></td><td>Location ID of the fault to be triggered. It must match the <strong>OpElectricalFault</strong> block’s Fault location ID.</td></tr><tr><td><strong>Initial Delay of Fault (sec)</strong></td><td>Disables faults until this simulation time is reached. In offline simulation, use this to reach steady state before the first fault is applied.</td></tr></tbody></table>

### OpElectricalFault

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

| Name                  | Description                                                                                                                                       |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fault location ID** | Identifier for this **OpElectricalFault** block. The fault is triggered when it matches the ID selected in the **OpElectricFaultSelector** block. |
| **Fault Resistance**  | Fault resistance of phases A, B, and C.                                                                                                           |
| **Ground Resistance** | Fault resistance of the ground path.                                                                                                              |
| Note                  | The fault type is selected in the **OpElectricFaultSelector** block.                                                                              |

## Inputs

### OpPOWFaultControl

| Name              | Description                                                                               |
| ----------------- | ----------------------------------------------------------------------------------------- |
| **sync\_BUS(pu)** | POW synchronization voltage (3‑phase) in per-unit. Scale so the peak amplitude is near 1. |
| **Fault params**  | POW parameter signal from the **OpElectricFaultSelector** block.                          |

### OpElectricFaultSelector <a href="#opelectricfaultselector" id="opelectricfaultselector"></a>

This block has no inputs.

### OpElectricFault <a href="#opelectricfaultselector" id="opelectricfaultselector"></a>

| Name               | Description                                                                                                |
| ------------------ | ---------------------------------------------------------------------------------------------------------- |
| **Trigger signal** | Applies the fault when set to 1 and when the current block’s location matches the selected fault location. |
| **Fault\_params**  | Signal used to choose the fault type dynamically. Connect to the **OpElectricFaultSelector** block.        |

## Outputs

### OpPOWFaultControl <a href="#oppowfaultcontrol" id="oppowfaultcontrol"></a>

| Name              | Description                                                                   |
| ----------------- | ----------------------------------------------------------------------------- |
| **Acq trigger**   | Trigger signal for OpTrigger blocks used for triggered acquisition.           |
| **Fault Trigger** | Time trigger for fault application (connect to **OpElectricalFault** blocks). |

### OpElectricFaultSelector

| Name                              | Description                                                                                               |
| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Fault parameters and location** | Outputs the fault parameters and the fault location data to be connected to **OpElectricalFault** blocks. |

### OpElectricFault <a href="#opelectricfaultselector" id="opelectricfaultselector"></a>

This block has no outputs.


---

# 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-faults-and-pow-synchronization-blocks-a-dedoubler.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.
