> 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/multimeter.md).

# Multimeter

## Description

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

The **Multimeter** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, measures the voltages and currents specified in the Measurements parameter of SPS Software blocks in your model.

Choosing voltages or currents through the Multimeter block is equivalent to connecting an internal voltage or current measurement block inside your blocks.

#### Polarity of Measured Voltages and Currents

The polarity of the measured voltages and current is determined by the + and - terminals of the measured SPS Software blocks. The following table identifies the positive terminals of the SPS Software blocks that do not have the + sign to identify block polarity.

| **Block**                                                                                                                                                                                                                                                                                                                                                                               | **Positive terminal(s)** |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| <p><a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/passives/mutual-inductance.md">Mutual Inductance</a><br><a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/passives/three-phase-mutual-inductance-z1-z0.md">Three-Phase Mutual Inductance Z1-Z0</a></p>                 | <p>1 2 3<br>ABC</p>      |
| <p><a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/passives/three-phase-series-rlc-branch.md">Three-Phase Series RLC Branch</a><br><a href="https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/passives/three-phase-parallel-rlc-branch.md">Three-Phase Parallel RLC Branch</a></p> | <p>ABC<br>ABC</p>        |
| [Three-Phase Breaker](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/breakers-and-faults/three-phase-breaker.md)                                                                                                                                                                                                                        | ABC                      |
| [Breaker](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/basics/breakers-and-faults/breaker.md)                                                                                                                                                                                                                                                | 1                        |

For three-phase transformers, the voltage polarities and positive current directions are indicated by the signal labels used in the Multimeter block. For example, Uan\_w2 = phase A-to-neutral voltage of the Y connected winding #2 and Iab\_w1 = winding current flowing from A to B in the delta-connected winding #1.

The Multimeter block is not designed to be used in a model that contains more than one powergui block.

## Parameters

<table data-header-hidden><thead><tr><th width="250.13323974609375"></th><th></th></tr></thead><tbody><tr><td><strong>Available Measurements</strong> — Available measurements in block</td><td><p>Available measurements in the Multimeter block. Click <strong>Select</strong> to select measurements from the list. When you select a measurement, the measurement moves from the <strong>Available Measurements</strong> list to the <strong>Output Measurements</strong> list.</p><p>Click <strong>Refresh</strong> to refresh the list of available measurements.</p><p>The measurements in the list are identified by the name of the block where the measurement is done.</p><p>The type of measurement (voltage measurement, current measurement, or flux) is defined by a label preceding the block name. For more information, see the <strong>Measurements</strong> parameter description in the Parameters section of blocks in your model.</p></td></tr><tr><td><strong>Output Measurements</strong> — Measurements output by block</td><td><p>Measurements output by the block. You can reorder the measurements by using the <strong>Up</strong>, <strong>Down</strong>, and <strong>Remove</strong> buttons.</p><p>The <strong>+/–</strong> button allows you to reverse the polarity of a selected measurement.</p></td></tr><tr><td><strong>Plot Output Measurements at simulation</strong> — Option to plot output measurements at simulationoff (default) | on</td><td>Select to display a plot of selected measurements in a MATLAB figure window. The plot is generated when the simulation stops.</td></tr><tr><td><strong>Output type</strong> — Format of output signalsComplex (default) | Real-Imag | Magnitude-Angle | Magnitude</td><td><p>Specifies the format of the output signals when the block is used in a phasor simulation. Set to Complex (default) to output the selected measurements as complex values. The outputs are complex signals.</p><p>Set to Real-Imag to output the real and imaginary parts of the measurements.</p><p>For each selected measurement, the multimeter outputs the real and imaginary parts.</p><p>Set to Magnitude-Angle to output the magnitude and angle of the selected measurements. For each selected measurement, the multimeter outputs the magnitude and angle values.</p><p>Set to Magnitude to output the magnitude of the selected measurements.</p><p>#### Dependencies To enable this parameter, in the Powergui block, set the <strong>Solver type</strong> parameter to Phasor.</p></td></tr></tbody></table>

## Examples

The power\_compensated example uses a Multimeter block to measure the voltage across the secondary winding of a Saturable Transformer block and the currents flowing through two Series RLC Load blocks.

The output of the Multimeter block is connected to a Scope block in order to display the measurements during the simulation. In addition, you can select the **Plot selected measurements** parameter to display a plot of selected measurements when simulation stops.

Open the Multimeter block dialog box and select the signals you want to observe, as described in the Parameters section. Notice the labels used to define the available measurements in the Multimeter block. For a description of these labels, see the reference section of the Saturable Transformer block and Series RLC Load block.

Start the simulation. After 0.4 seconds, the simulation stops and a MATLAB<sup>®</sup> figure window opens to display the selected measurements in the Multimeter 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/measurement/multimeter.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.
