> 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/hypersim/simulation-control-monitoring-and-logging/use-hypersim-built-in-tools/run-impedance-measurement.md).

# Run Impedance Measurement

## Overview

The **Impedance Measurement** feature enables users to measure the frequency-dependent impedance of a three-phase electrical circuit as seen from a selected bus.

**Impedance Measurement** can be accessed from the HYPERSIM ribbon.

## Supported features

* Measures the equivalent impedance (or admittance) seen from a selected bus across a specified frequency range.
* Displays the calculated magnitude and phase angle results in either graphical or tabular form.
* Performs impedance calculations based on the initial states of all switches in the network.
* Models voltage sources using their internal impedances (short-circuit equivalent) and disconnects power sources from the network (open-circuit equivalent).
* Automatically replaces synchronous machines with their equivalent shunt impedance to ground during the impedance calculation:\
  $$R = Ra , \text{and} , L = 0.5\*(Xd2 + Xq2)$$

## Run the Impedance Measurement tool

### Parameters

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-44608d595c0ad408eb72dd9c186dac3466927ebc%2Fimpedance-measurement-parameter.png?alt=media" alt=""><figcaption></figcaption></figure>

| Parameter         | Description                              |
| ----------------- | ---------------------------------------- |
| **Bus**           | Name of the Bus in the system            |
| **Frequency min** | Minimum Frequency (Hz)                   |
| **Frequency max** | Maximum Frequency (Hz)                   |
| **Increment**     | Frequency scan resolution increment (Hz) |

### Results

Select the bus of interest, define the frequency range and increment, and click **Run** to generate the impedance data and graph.

**Data**

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-95bb60159539c783a7315086919cdc233e0f8a88%2Fimpedance-measurement-data.png?alt=media" alt="" width="452"><figcaption></figcaption></figure>

The **Data** tab displays the measured impedance magnitude and phase angle values based on the selected measurement parameters. Results can be exported to a **.csv** file for further analysis.

**Graph**

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-0911ed75021d5c1efdc0b0aaa3a91f28e3035c35%2F%C3%ACmpedance-measurement-graph-online.png?alt=media" alt="" width="452"><figcaption><p>Online graph</p></figcaption></figure>

HYPERSIM uses a **Google Charts plugin** to display the measurement results as interactive HTML graphs and need an internet connection:

* Use the **Single Graph** option to combine all curves into a single graph.
* Zoom in by scrolling with the mouse wheel. To return to the original view, right-click the graph.
* Export the graph to an HTML file for viewing or sharing outside HYPERSIM.

## Limitations

* A circuit analysis must be completed before using the impedance measurement feature.
* Only positive-sequence (direct-sequence) networks are supported.
* Single-phase components are not included in the impedance calculation.
* Components connected to buses with a nominal voltage of zero are ignored.
* For nonlinear components, only the first linear segment is considered during the calculation.


---

# 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/hypersim/simulation-control-monitoring-and-logging/use-hypersim-built-in-tools/run-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.
