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

# Impedance Measurement

## Description

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

The **Impedance Measurement** block, located in the **OPAL-RT SPS Software/Sensors and Measurements** library, measures the impedance between two nodes of a linear circuit as a function of the frequency.

It consists of a current source Iz, connected between inputs one and two of the Impedance Measurement blocks, and a voltage measurement Vz, connected across the terminals of the current source. The network impedance is calculated as the transfer function H(s) from the current input to the voltage output of the state-space model.

$$
H(s)=\frac{V\_z(s)}{I\_z(s)}
$$

The impedance (magnitude and phase) as function of frequency is displayed by using the Impedance versus Frequency Measurement tool of the powergui block.

The measurement takes into account the initial states of the Breaker and Ideal Switch blocks. It also allows impedance measurements with Distributed Parameters Line blocks in your circuit.

The source impedances are taken into account in the impedance calculations. By definition, the impedance of voltage sources is 0 (voltage source blocks are considered as short-circuit) and the impedance of current sources is infinite (current source blocks are considered as open-circuit).

In some applications, you may need to delete current or voltage source blocks manually in order to ignore their impact on impedance calculations.

## Ports

#### Conserving

<table data-header-hidden><thead><tr><th width="249.7332763671875"></th><th></th></tr></thead><tbody><tr><td><strong>Cons 1</strong> — Electric terminal of line SPS electrical</td><td>SPS electrical conserving port associated with one node of a linear circuit.</td></tr><tr><td><strong>Cons 2</strong> — Electric terminal of line SPS electrical</td><td>SPS electrical conserving port associated with one node of a linear circuit.</td></tr></tbody></table>

## Parameters

<table data-header-hidden><thead><tr><th width="249.86669921875"></th><th></th></tr></thead><tbody><tr><td><strong>Multiplication factor</strong> — Rescale value for measured impedance1 (default) | positive scalar</td><td><p>If you use the Impedance Measurement block in a three-phase circuit, you can use the <strong>Multiplication factor</strong> parameter to rescale the measured impedance.</p><p>For example, measuring the impedance between two phases of a three-phase circuit gives two times the positive-sequence impedance.</p><p>Therefore you must apply a multiplication factor of 1/2 to the impedance in order to obtain the correct positive-sequence impedance value. Similarly, to measure the zero-sequence impedance of a balanced three-phase circuit, you can connect the Impedance Measurement block between ground or neutral and the three phases connected together.</p><p>In that case, you are measuring one third of the zero-sequence impedance and you must apply a multiplication factor of 3 to obtain the correct zero-sequence value.</p></td></tr></tbody></table>

## Limitations

The only nonlinear blocks that are taken into account during the impedance measurement are the Breaker, Three-Phase Breaker, Three-Phase Fault, Ideal Switch, and Distributed Parameters Line blocks. All other nonlinear blocks, such as machines and power electronic devices, are not considered, and they are disconnected during the measurement.

If you plan to connect the Impedance Measurement block in series with an inductance, a current source, or any nonlinear element, you must add a large resistor across the terminals of the block, because the Impedance Measurement block is simulated as a current source 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/impedance-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.
