> 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/model-and-simulation/import-models-from-external-software-or-code/import-from-emtp/adjust-the-model-for-load-flow.md).

# Adjust the Model for Load Flow

This page describes the differences in load flow behavior between **EMTP** and **HYPERSIM**, and provides guidelines to obtain consistent and valid results when running load flow in HYPERSIM.

## Key difference

Since load flow calculations are handled differently in EMTP and HYPERSIM, load flow results in HYPERSIM may differ from those obtained in EMTP, especially for unbalanced systems or models relying on detailed phase representation.

* **EMTP**
  * Supports **three‑phase load flow**
  * Can represent **unbalanced systems**
* **HYPERSIM**
  * Supports **balanced load flow only**
  * Uses a **positive‑sequence equivalent** representation

## Adjustement procedure

{% stepper %}
{% step %}

## Confirm model type (balanced vs unbalanced)

1. Check if the EMTP model include unbalanced elements or single-phase modeling. HYPERSIM supports **balanced load flow only.**
2. Replace single-phase or unbalanced subsystems with **equivalent three-phase components** OR accept that load flow results will differ.
   {% endstep %}

{% step %}

## Verify PV nodes and reactive power limits

1. Check if PV buses reach or exceed **Qmin / Qmax** limits. In EMTP, PV constraints may remain active without warning, while HYPERSIM always switches to PQ when limits are exceeded.
2. Adjust Qmin and Qmax limits, or modify the voltage setpoint, network parameters (inductance or capacitance), or bus type (PV → PQ).
   {% endstep %}

{% step %}

## Check for remote voltage control

1. Check if the EMTP model uses voltage control at a remote bus (different from the load flow bus). This is supported in EMTP but not in HYPERSIM, where the PV constraint can only be applied to the local bus.
2. Use the voltage magnitude obtained from the EMTP load flow solution and adjust the local bus voltage in HYPERSIM to achieve equivalent behavior.
   {% endstep %}

{% step %}

## Validate nominal voltages in subsystems

1. Check if multiple instances of the same subsystem use different nominal voltages. Automatic assignment may lead to incorrect voltage levels.
2. Define the nominal voltage as a mask parameter and assign it explicitly to internal buses.

Example:

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-d0dd63140237a03d523d4e0ae110aa00b633e3ec%2Femtp-nominal-voltage.png?alt=media" alt="" width="286"><figcaption></figcaption></figure>

The Ubase parameter in the mask is used to define the nominal voltage of the internal buses.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-501beb283fd68e9b2903827ef81137ba24350163%2Femtp-nominal-voltage-ubase.png?alt=media" alt="" width="320"><figcaption></figcaption></figure>

Then, the nominal voltage parameter is entered in the internal bus.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-4fe812abcee9979bdc7fe3f5903fecbd676927be%2Femtp-nominal-voltage-internal-bus.png?alt=media" alt="" width="320"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

## Ensure all subsystems are considered in load flow

1. Check if subsystems are built using single-phase components. These are ignored in HYPERSIM load flow calculations.
2. Replace affected subsystems with equivalent three-phase components or ensure critical elements are visible to the load flow solver.
   {% endstep %}

{% step %}

## Validate load flow initialization

1. Check if load flow results differ significantly at simulation start. This may indicate initialization issues.
2. Re-run load flow after applying corrections and compare key bus voltages with EMTP results.
   {% endstep %}
   {% endstepper %}


---

# 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/model-and-simulation/import-models-from-external-software-or-code/import-from-emtp/adjust-the-model-for-load-flow.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.
