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

# Current Measurement

## Description

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

The **Current Measurement** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, the current measurement block is used to measure the instantaneous current flowing in any electrical block or connection line.

The Simulink® output provides a Simulink signal that can be used by other Simulink blocks.

## Ports

### Output

<table data-header-hidden><thead><tr><th width="250.35546875"></th><th></th></tr></thead><tbody><tr><td><strong>i</strong> — Output Scalar</td><td>Simulink signal associated with the instantaneous current flowing in any block or connection line.</td></tr></tbody></table>

### Conserving

<table data-header-hidden><thead><tr><th width="249.99993896484375"></th><th></th></tr></thead><tbody><tr><td><strong>+</strong> — Positive terminal SPS electrical</td><td>SPS electrical conserving port associated with the positive terminal of the Current Measurement block.</td></tr><tr><td><strong>-</strong> — Negative terminal SPS electrical</td><td>SPS electrical conserving port associated with the negative terminal of the Current Measurement block.</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="250.22216796875"></th><th></th></tr></thead><tbody><tr><td><strong>Output signal</strong> — Output signalComplex (default) | Real-Imag | Magnitude-Angle | Magnitude</td><td><p>Format of the output signal to use when you use the block in a phasor simulation.</p><p>Set this parameter to Complex to output the measured current as a complex value.</p><p>The output is a complex signal.</p><p>Set this parameter to Real-Imag to output the real and imaginary parts of the measured current.</p><p>The output is a vector of two elements. Set this parameter to Magnitude-Angle to output the magnitude and angle of the measured current.</p><p>The output is a vector of two elements. Set this parameter to Magnitude to output the magnitude of the measured current. The output is a scalar value.</p><p>#### Dependencies To enable this parameter, in the powergui block, set the <strong>Simulation type</strong> parameter to Phasor or Discrete Phasor.</p></td></tr></tbody></table>

## Examples

The power\_currmeasure example uses four Current Measurement blocks to read currents in different branches of a circuit.


---

# 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/current-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.
