> 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/pmu-pll-based-positive-sequence.md).

# PMU (PLL-Based, Positive-Sequence)

## Description

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

The **PMU (PLL-Based, Positive-Sequence)** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, implements a phasor measurement unit (PMU) using a phase-locked loop (PLL), which computes the positive-sequence component of the input *abc* signal over a running window of one cycle of fundamental frequency given by input *abc*. The signal can be a set of three balanced or unbalanced signals which may contain harmonics.

The PMU (PLL-Based, Positive-Sequence) block is inspired by the IEEE Std C37.118.1-2011.

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

The PLL (3ph) block tracks the frequency and phase of a sinusoidal three-phase signal (*abc*) by using an internal frequency oscillator. The control system adjusts the internal oscillator frequency to keep the phase difference at 0.

The Positive-Sequence (PLL-Driven) block computes the positive-sequence components (magnitude and phase) of a sinusoidal three-phase input signal (*abc*) over a running window of one cycle of the fundamental frequency tracked by the PLL (3ph) closed-loop control system. The reference frame required for the computation is given by the angle (rad, varying between 0 and 2\*pi), synchronized on zero crossings of the fundamental (positive-sequence) of phase A. The angle is also tracked by the PLL (3ph) closed-loop control system.

Because the block uses a running average window to perform the Fourier analysis, one cycle of simulation must complete before the outputs give the correct magnitude and angle. For example, the block response to a step change in the positive-sequence component of a three-phase signal is a *one-cycle ramp*. For the first cycle of simulation, the output is held constant at the values specified by the initial input parameters.

The three outputs of the PMU (PLL-Based, Positive-Sequence) block return the magnitude (same units as the input signal), the phase (in degrees relative to the PLL phase), and the frequency of the positive-sequence component of the *abc* input at the fundamental frequency, respectively.

The sample time (*Ts*) of the block, in seconds, is a function of the nominal frequency *fn* and the sampling rate *Nsr*.

Finally, the reporting rate (*Rt*), that determines the length of the interval over which an event will be reported, is related to the sample time using a reporting rate factor *k*, as follows:

$$
Rt=k\times Ts
$$

## Limitations

* Under subsynchronous conditions, the phasor estimation may present erroneous results.
* Time synchronization from the common time source of a global positioning systems (GPS) radio clock is implicit in the model.

## Ports

### Input

<table data-header-hidden><thead><tr><th width="249.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>abc</strong> — Signal<br>Vector</td><td>Three-phase sinusoidal voltage or current.<strong>Data Types:</strong>single | double</td></tr></tbody></table>

### Output

<table data-header-hidden><thead><tr><th width="249.91119384765625"></th><th></th></tr></thead><tbody><tr><td><strong>|u|</strong> — Magnitude<br>Scalar</td><td><p>Magnitude of the positive-sequence component of the <em>abc</em> input at the fundamental frequency in the same units as the input signal.</p><p><strong>Data Types:</strong> single | double</p></td></tr><tr><td><strong>∠u</strong> — Phase<br>Scalar</td><td>The phase, in degrees, relative to the PLL phase of the positive-sequence component of the <em>abc</em> input at the fundamental frequency.<strong>Data Types:</strong>single | double</td></tr><tr><td><strong>F</strong> — Frequency, Hz<br>Scalar</td><td><p>Frequency, in Hz, relative to the PLL phase of the positive-sequence component of the <em>abc</em> input at the fundamental frequency.</p><p><strong>Data Types:</strong> single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus</p></td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="249.95562744140625"></th><th></th></tr></thead><tbody><tr><td><strong>Nominal frequency fn (Hz)</strong> — Frequency<br>60 (default) | 50</td><td>Nominal frequency, <em>fn</em>, in Hz, of the three-phase input.</td></tr><tr><td><strong>Sampling rate Nsr (point/cycle)</strong> — Sampling rate<br>64 (default) | 4824</td><td>Sampling rate, <em>Nsr</em>, in point/cycle.</td></tr><tr><td><strong>Reporting rate factor [k]</strong> — Reporting rate<br>1 (default)</td><td><p>Sampling rate of the PMU.</p><p>This parameter multiplies the sample time to calculate the reporting rate. The reporting rate factor must be equal to or greater than 1.</p></td></tr></tbody></table>

## Examples

[Kundur's Two-Area System with PMU](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/control-and-measurements/kundurs-two-area-system-with-pmu.md): The use of the PMU (PLL-Based, Positive-Sequence) block within the Kundur’s Two-Area System.

[PMU (PLL-based, Positive-Sequence) Benchmark](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/control-and-measurements/pmu-pll-based-positive-sequence-benchmark.md): The use of a phasor measurement unit - PMU (PLL-based, Positive-Sequence) in a benchmark circuit.

## References <a href="#references" id="references"></a>

\[1] *IEEE Standard for Synchrophasor Measurements for Power Systems*. IEEE Std C37.118.1-2011 (Revision of IEEE Std C37.118-2005), pp. 1–61, 2011.

\[2] P. Kundur, N. J. Balu, and M. G. Lauby, *Power system stability and control*. Vol. 7. New York: McGraw-Hill, 1994.


---

# 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/pmu-pll-based-positive-sequence.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.
