> 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/measurement/three-phase-v-i-measurement.md).

# Three Phase V I Measurement

## Description

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

The **Three Phase V I Measurement** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, is used to measure instantaneous three-phase voltages and currents in a circuit.

When connected in series with three-phase elements, it returns the three phase-to-ground or phase-to-phase peak voltages and currents.

The block can output the voltages and currents in per unit (pu) values or in volts and amperes.

If you choose to measure phase-to-ground voltages in per unit, the block converts the measured voltages based on peak value of nominal phase-to-ground voltage:

$$
V\_{abc(\text{pu})}
===================

\frac{V\_{\text{phase to ground}}(V)}{V\_{\text{base}}(V)}
\\\[8pt]
$$

where

$$
V\_{\text{base}}
================

\frac{V\_{\text{nom}}(\text{Vrms})}{\sqrt{3}} \cdot \sqrt{2}
\\\[8pt]
$$

If you choose to measure phase-to-phase voltages in per unit, the block converts the measured voltages based on peak value of nominal phase-to-phase voltage:

$$
V\_{abc(\text{pu})}
===================

\frac{V\_{\text{phase to phase}}(V)}{V\_{\text{base}}(V)}
\\\[8pt]
$$

where

$$
V\_{\text{base}}
================

V\_{\text{nom}}(\text{Vrms}) \cdot \sqrt{2}
\\\[8pt]
$$

If you choose to measure currents in per unit, the block converts the measured currents based on the peak value of the nominal current:

$$
I\_{abc(\text{pu})}
===================

\frac{I\_{abc}(A)}{I\_{\text{base}}(A)}
\\\[8pt]
$$

where

$$
I\_{\text{base}}
================

\frac{P\_{\text{base}}}{V\_{\text{nom}}} \cdot \frac{\sqrt{2}}{\sqrt{3}}
\\\[8pt]
$$

V<sub>nom</sub> and P<sub>base</sub> are specified in the Three-Phase V-I Measurement block dialog box.

The steady-state voltage and current phasors measured by the Three-Phase V-I Measurement block can be obtained from the Powergui block by selecting **Steady-State Voltages and Currents**.

The phasor magnitudes displayed in the Powergui stay in peak or RMS values even if the output signals are converted to pu.

## Ports

### Output

<table data-header-hidden><thead><tr><th width="249.9554443359375"></th><th></th></tr></thead><tbody><tr><td><strong>Vabc</strong> — Measured phase-to-ground or phase-to-phase voltages Simulink® signal</td><td>The three measured phase-to-ground or phase-to-phase voltages. The Vabc output disappears when the <strong>Use a label</strong> parameter is selected or when the <strong>Voltage measurement</strong> menu is set to no.</td></tr><tr><td><strong>Iabc</strong> — Measured line currents Simulink signal</td><td>The three measured line currents. The Iabc output disappears when the <strong>Use a label</strong> parameter is selected or when the <strong>Current measurement</strong> menu is set to no.</td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="249.82220458984375"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A SPS electrical</td><td>SPS electrical conserving port associated with the phase A voltage and current</td></tr><tr><td><strong>B</strong> — Phase B SPS electrical</td><td>SPS electrical conserving port associated with the phase B voltage and current</td></tr><tr><td><strong>C</strong> — Phase C SPS electrical</td><td>SPS electrical conserving port associated with the phase C voltage and current</td></tr><tr><td><strong>a</strong> — Phase a SPS electrical</td><td>SPS electrical conserving port associated with the phase a voltage and current</td></tr><tr><td><strong>b</strong> — Phase b SPS electrical</td><td>SPS electrical conserving port associated with the phase b voltage and current</td></tr><tr><td><strong>c</strong> — Phase c SPS electrical</td><td>SPS electrical conserving port associated with the phase c voltage and current</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="249.64453125"></th><th></th></tr></thead><tbody><tr><td><strong>Voltage measurement</strong> — Voltage measurement optionno (default) | phase-to-ground | phase-to-phase</td><td><p>Select no if you do not want to measure three-phase voltage.</p><p>Select phase-to-ground (default) if you want to measure the phase-to-ground voltages. Select phase-to-phase if you want to measure the phase-to-phase voltages.</p></td></tr><tr><td><strong>Use a label</strong> — Label usageoff (default) | on</td><td><p>If selected, the voltage measurements are sent to a labeled signal. Use a From block to read the voltages.</p><p>The Goto tag of the From block must correspond to the label specified by the <strong>Signal label</strong> parameter.</p><p>If cleared, the voltage measurements are available via the Vabc output of the block. Default is cleared.</p></td></tr><tr><td><strong>Signal label (use a From block to collect this signal)</strong> — Label tagVabc (default)</td><td><p>Specifies a label tag for the voltage measurements.</p><p>default is Vabc.</p></td></tr><tr><td><strong>Voltages in pu, based on peak value of nominal phase-to-ground voltage</strong> — Phase-to-ground voltages in puoff (default) | on</td><td><p>If selected, the measured phase-to-ground voltages are converted in pu.</p><p>Default is cleared.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>For new models, this parameter is not available if the <strong>Voltage measurement</strong> parameter is set to phase-to-phase or no. However, this parameter is available and selected for a model saved from a previous release with the <strong>Voltage measurement</strong> parameter set to phase-to-phase and the <strong>Voltages in pu</strong> option selected. In such a case, you can choose to keep this parameter as is for compatibility purposes. You can also choose to clear this parameter and select the <strong>Voltages in pu, based on peak value of nominal phase-to-phase voltage</strong> parameter. You then need to take into account the impact of this new per unit conversion in your model</p></div></td></tr><tr><td><strong>Voltages in pu, based on peak value of nominal phase-to-phase voltage</strong> — Phase-to-phase voltages in puoff (default) | on</td><td>If selected, the measured phase-to-phase voltages are converted in pu. This parameter is not available if <strong>Voltage measurement</strong> parameter is set to phase-to-ground or no. Default is .</td></tr><tr><td><strong>Current measurement</strong> — Current measurement optionno (default) | yes</td><td>Select yes (default) if you want to measure the three-phase currents that flow through the block.</td></tr><tr><td><strong>Use a label</strong> — Label usageoff (default) | on</td><td><p>If selected, the current measurements are sent to a labeled signal. Use a From block to read the currents.</p><p>The Goto tag of the From block must correspond to the label specified by the <strong>Signal label</strong> parameter.</p><p>If cleared, the current measurements are available via the Iabc output of the block. Default is cleared.</p></td></tr><tr><td><strong>Signal label (use a From block to collect this signal)</strong> — Label tagIabc (default)</td><td><p>Specifies a label tag for the current measurements.</p><p>Default is Iabc.</p></td></tr><tr><td><strong>Currents in pu</strong> — Currents in puoff (default) | on</td><td><p>If selected, the three-phase currents are measured in pu.</p><p>Otherwise they are measured in amperes. Default is cleared.</p></td></tr><tr><td><strong>Base power ( VA 3 phase)</strong> — Three-phase base power100e6 (default)</td><td><p>The three-phase base power, in volt-ampere (VA), used to convert the measured currents in pu.</p><p>The <strong>Base power (VA 3 phase)</strong> parameter is not available if <strong>Currents in pu</strong> is cleared.</p></td></tr><tr><td><strong>Nominal voltage used for pu measurement (Vrms phase-phase)</strong> — Nominal voltage in RMS500e3 (default)</td><td><p>The nominal voltage, in volts RMS, used to convert the measured voltages in pu.</p><p>This parameter is not available if the <strong>Voltage measurement</strong> parameter is set to no.</p><p>Default is 500e3.</p></td></tr><tr><td><strong>Output signals in</strong> — Format of measured signalsComplex (default) | Real-Imag | Magnitude-Angle | Magnitude</td><td><p>Specifies the format of the measured signals when the block is used in a phasor simulation. The <strong>Output signals in</strong> parameter is enabled when the <strong>Simulation type</strong> parameter of the powergui block is set to Phasor or Discrete phasor.</p><p>Set to Complex (default) to output the measured voltages and currents as complex values. The outputs are complex signals.</p><p>Set to Real-Imag to output the real and imaginary parts of the measured voltages and currents.</p><p>Set to Magnitude-Angle to output the magnitudes and angles of the measured voltages and currents.</p><p>Set to Magnitude to output the magnitudes of the measured voltages and currents.</p><p>The output is a scalar value.</p></td></tr></tbody></table>

## Examples

[Three-Phase Series Compensated Network](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/command-based-access-to-sps-examples.md)

The use of three-phase blocks to study transients on a series-compensated 735-kV transmission system.


---

# 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/measurement/three-phase-v-i-measurement.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.
