> 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/control-and-measurements/analysis/three-phase-sequence-analyzer.md).

# Three Phase Sequence Analyzer

## Description

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

The **Three Phase Sequence Analyzer** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, measures positive-, negative-, and zero-sequence components of three-phase signal.

The Three-Phase Sequence Analyzer block outputs the magnitude and phase of the positive- (denoted by the index 1), negative- (index 2), and zero-sequence (index 0) components of a set of three balanced or unbalanced signals. The signals can contain harmonics or not. The three sequence components of a three-phase signal (voltages V1 V2 V0 or currents I1 I2 I0) are computed as follows:

$$
V\_1 = (V\_a + aV\_b+ a^2V\_c) / 3V\_2 = (Va + a^2V\_b + aV\_c) / 3V\_0 = (V\_a + V\_b + V\_c)/3
$$

where:

*V*<sub>*a*</sub>, *V*<sub>*b*</sub>, *V*<sub>*c*</sub> = three voltage phasors at specified frequency

a = *e*<sup>*j*</sup><sup>2</sup><sup>*π*</sup>/3 = 1∠120° complex operator.

A Fourier analysis over a sliding window of one cycle of the specified frequency is first applied to the three input signals.

It evaluates the phasor values *V*<sub>*a*</sub>, *V*<sub>*b*</sub>, and *V*<sub>*c*</sub> at the specified fundamental or harmonic frequency. Then the transformation is applied to obtain the positive sequence, negative sequence, and zero sequence.

The Three-Phase Sequence Analyzer block is not sensitive to harmonics or imbalances.

However, as this block uses a running average window to perform the Fourier analysis, one cycle of simulation has to be completed before the outputs give the correct magnitude and angle.

For example, its response to a step change of *V*<sub>1</sub> is a one-cycle ramp.

The discrete version of this block allows you to specify the initial magnitude and phase of the output signal. For the first cycle of simulation, the outputs are held to the values specified by the initial input parameter.

You can modify any parameter during the simulation in order to obtain the different sequence and harmonic components of the input signals.

## Parameters

<table data-header-hidden><thead><tr><th width="249.66668701171875"></th><th></th></tr></thead><tbody><tr><td><strong>Fundamental frequency f1</strong></td><td>The fundamental frequency, in hertz, of the three-phase input signal.</td></tr><tr><td><strong>Harmonic n</strong></td><td>Specify the harmonic component from which you want to evaluate the sequences. For DC, enter 0. For fundamental, enter 1.</td></tr><tr><td><strong>Sequence</strong></td><td><p>Specify which sequence component the block outputs.</p><p>Select Positive to calculate the positive sequence, select Negative to calculate the negative sequence, select 0 to compute the zero sequence of the fundamental or specified harmonic of the three-phase input signal.</p><p>Select Positive Negative Zero to get all the sequences.</p></td></tr></tbody></table>

### Inputs and Outputs

<table data-header-hidden><thead><tr><th width="249.88885498046875"></th><th></th></tr></thead><tbody><tr><td><strong>abc</strong></td><td>Connect to the input the vectorized signal of the three [a b c] sinusoidal signals.</td></tr><tr><td><strong>Mag</strong></td><td>The first output gives the magnitude (peak value) of the specified sequence component, in the same units as the abc input signals.</td></tr><tr><td><strong>Phase</strong></td><td>The second output gives the phase in degrees of the specified component(s).</td></tr></tbody></table>

## Examples

The power\_3phsignalseq example illustrates the use of the Sequence Analyzer block (the improved version of the Three-Phase Sequence Analyzer block).


---

# 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/control-and-measurements/analysis/three-phase-sequence-analyzer.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.
