> 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/scopeview/use-functions/harmonic-analysis-functions/harmonic-analysis-or-zseq.md).

# Harmonic Analysis | ZSEQ

## **SEQUENCE IMPEDANCE – \[ZSEQ]**

Compute the sequence impedance matrix in function of the phase impedance matrix. The input and output are represented by phasors.

## **CATEGORY**

Harmonic\_Analysis

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/1td8EfLTMXFrFhU35otk/image2018%209%2024_15%201%2038.png)

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/Sa5wZkCiBvigWmdu5hmQ/image2018%209%2024_15%201%2043.png)

## **DESCRIPTION**

Output the sequence impedance matrix in function of an phase impedance matrix. The following equations are used to calculate the impedences:

$$
a = 1 \angle 120^\circ \\\[8pt]

a^2 = 1 \angle 240^\circ \\\[8pt]

Z\_{00} = \frac{1}{3}(Z\_{aa} + Z\_{bb} + Z\_{cc} + 2Z\_{ab} + 2Z\_{ac} + 2Z\_{bc}) \\\[8pt]

Z\_{11} = Z\_{22} = \frac{1}{3}(Z\_{aa} + Z\_{bb} + Z\_{cc} - Z\_{ab} - Z\_{ac} - Z\_{bc}) \\\[8pt]

Z\_{01} = Z\_{20} = \frac{1}{3}(Z\_{aa} + a^2 Z\_{bb} + a Z\_{cc} - a Z\_{ab} - a^2 Z\_{ac} - Z\_{bc}) \\\[8pt]

Z\_{02} = Z\_{10} = \frac{1}{3}(Z\_{aa} + a Z\_{bb} + a^2 Z\_{cc} - a^2 Z\_{ab} - a Z\_{ac} - Z\_{bc}) \\\[8pt]

Z\_{12} = \frac{1}{3}(Z\_{aa} + a^2 Z\_{bb} + a Z\_{cc} + 2a Z\_{ab} + 2a^2 Z\_{ac} + 2Z\_{bc}) \\\[8pt]

Z\_{21} = \frac{1}{3}(Z\_{aa} + a Z\_{bb} + a^2 Z\_{cc} + 2a^2 Z\_{ab} + 2a Z\_{ac} + 2Z\_{bc}) \\\[8pt]
$$

## **RESULT VARIABLES AND PARAMETERS**

**Results**:

<table data-header-hidden><thead><tr><th width="101.99993896484375"></th><th width="254"></th></tr></thead><tbody><tr><td><strong>Z00_mag</strong></td><td>Magnitude of the Z00</td></tr><tr><td><strong>Z01_mag</strong></td><td>Magnitude of the Z01</td></tr><tr><td><strong>Z02_mag</strong></td><td>Magnitude of the Z02</td></tr><tr><td><strong>Z10_mag</strong></td><td>Magnitude of the Z10</td></tr><tr><td><strong>Z11_mag</strong></td><td>Magnitude of the Z11</td></tr><tr><td><strong>Z12_mag</strong></td><td>Magnitude of the Z12</td></tr><tr><td><strong>Z20_mag</strong></td><td>Magnitude of the Z20</td></tr><tr><td><strong>Z21_mag</strong></td><td>Magnitude of the Z21</td></tr><tr><td><strong>Z22_mag</strong></td><td>Magnitude of the Z22</td></tr><tr><td><strong>Z00_ang</strong></td><td>Angle of the Z00 (in degrees)</td></tr><tr><td><strong>Z01_ang</strong></td><td>Angle of the Z01 (in degrees)</td></tr><tr><td><strong>Z02_ang</strong></td><td>Angle of the Z02 (in degrees)</td></tr><tr><td><strong>Z10_ang</strong></td><td>Angle of the Z10 (in degrees)</td></tr><tr><td><strong>Z11_ang</strong></td><td>Angle of the Z11 (in degrees)</td></tr><tr><td><strong>Z12_ang</strong></td><td>Angle of the Z12 (in degrees)</td></tr><tr><td><strong>Z20_ang</strong></td><td>Angle of the Z20 (in degrees)</td></tr><tr><td><strong>Z21_ang</strong></td><td>Angle of the Z21 (in degrees)</td></tr><tr><td><strong>Z22_ang</strong></td><td>Angle of the Z22 (in degrees)</td></tr></tbody></table>

**Signals:**

<table data-header-hidden><thead><tr><th width="106.7999267578125"></th><th width="379.60009765625"></th></tr></thead><tbody><tr><td><strong>Zaa_mag</strong></td><td>Magnitude of the Zaa</td></tr><tr><td><strong>Zab_mag</strong></td><td>Magnitude of the Zab</td></tr><tr><td><strong>Zac_mag</strong></td><td>Magnitude of the Zac</td></tr><tr><td><strong>Zba_mag</strong></td><td>Magnitude of the Zba (not required)</td></tr><tr><td><strong>Zbb_mag</strong></td><td>Magnitude of the Zbb</td></tr><tr><td><strong>Zbc_mag</strong></td><td>Magnitude of the Zbc</td></tr><tr><td><strong>Zca_mag</strong></td><td>Magnitude of the Zca (not required)</td></tr><tr><td><strong>Zcb_mag</strong></td><td>Magnitude of the Zcb (not required)</td></tr><tr><td><strong>Zca_mag</strong></td><td>Magnitude of the Zcc</td></tr><tr><td><strong>Zaa_ang</strong></td><td>Angle of the Zaa (in degrees)</td></tr><tr><td><strong>Zab_ang</strong></td><td>Angle of the Zab (in degrees)</td></tr><tr><td><strong>Zac_ang</strong></td><td>Angle of the Zac (in degrees)</td></tr><tr><td><strong>Zba_ang</strong></td><td>Angle of the Zba (in degrees) (not required)</td></tr><tr><td><strong>Zbb_ang</strong></td><td>Angle of the Zbb (in degrees)</td></tr><tr><td><strong>Zbc_ang</strong></td><td>Angle of the Zbc (in degrees)</td></tr><tr><td><strong>Zca_ang</strong></td><td>Angle of the Zca (in degrees)</td></tr><tr><td><strong>Zcb_ang</strong></td><td>Angle of the Zcb (in degrees) (not required)</td></tr><tr><td><strong>Zcc_ang</strong></td><td>Angle of the Zcc (in degrees) (not required)</td></tr></tbody></table>

## **SYNTAX**

**\[Z00\_mag,Z01\_mag,Z02\_mag,Z10\_mag,Z11\_mag,Z12\_mag,Z20\_mag,Z21\_mag,Z22\_mag,Z00\_ang,Z01\_ang,Z02\_ang,Z10\_ang,Z11\_ang,Z12\_ang,Z20\_ang,Z21\_ang,Z22\_ang]** = zseq(Zaa\_mag,Zab\_mag,Zac\_mag,Zba\_mag,Zbb\_mag,Zbc\_mag,Zca\_mag,Zcb\_mag,Zcc\_mag,Zaa\_ang,Zab\_ang,Zac\_ang,Zba\_ang,Zbb\_ang,Zbc\_ang,Zca\_ang,Zcb\_ang,Zcc\_ang)

## **CHARACTERISTICS**

Data type support

Double Floating point

## **EXAMPLE**

For this example, a phase impedance matrix is created and the sequence impedance will be computed by zseq function.

This matrix is imported through ScopeView:

$$
Z\_{a,b,c}
\begin{bmatrix}
Z\_{aa} & Z\_{ab} & Z\_{ac} \\
Z\_{ba} & Z\_{bb} & Z\_{bc} \\
Z\_{ca} & Z\_{cb} & Z\_{cc}
\end{bmatrix}
=============

\begin{bmatrix}
0.22361 \angle 63.4349 & 0.22361 \angle 26.5651 & 0.36056 \angle 33.6901 \\
0.22361 \angle 26.5651 & 0.36056 \angle 56.3099 & 0.56569 \angle 45 \\
0.36056 \angle 33.6901 & 0.56569 \angle 45 & 0.31623 \angle 18.4349
\end{bmatrix}
\\\[8pt]
$$

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/owkmilTXbY7w0nbI9bXR/Matrix%20ScopeView.png)

Using the zseq function and putting the result in a table:

![](https://content.gitbook.com/content/fwfLeQP2Iaoefor0ZUNi/blobs/OE5HAAY1w2D77fPw2sKa/zseq%20function.png)

Which corresponds to this matrix:

$$
Z\_{0,1,2}
\begin{bmatrix}
Z\_{00} & Z\_{01} & Z\_{02} \\
Z\_{10} & Z\_{11} & Z\_{12} \\
Z\_{20} & Z\_{21} & Z\_{22}
\end{bmatrix}
=============

\begin{bmatrix}
1.04138 \angle 39.80558 & 0.07560 \angle -160.20773 & 0.19107 \angle -132.41219 \\
0.19107 \angle -132.41219 & 0.10541 \angle -161.56515 & 0.21534 \angle 39.78642 \\
0.07560 \angle -160.20773 & 0.20621 \angle 108.51233 & 0.10541 \angle -161.56515
\end{bmatrix}
\\\[8pt]
$$


---

# 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/scopeview/use-functions/harmonic-analysis-functions/harmonic-analysis-or-zseq.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.
