> 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/prepare-the-simulation/run-load-flow-analysis/run-the-load-flow.md).

# Run the Load Flow

## Overview

The **Load Flow** tool in the **HYPERSIM** ribbon provides the following capabilities:

* Initialize the simulation from a **steady-state operating point**.
* Enforce the **reactive power limits** (minimum and maximum) of machines and sources.

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

In the Load Flow window, several load flow options and parameters are available for configuration.

{% tabs %}
{% tab title="Menu" %}

<table data-search="false"><thead><tr><th width="200">Command</th><th>Description</th></tr></thead><tbody><tr><td><strong>Analyse</strong></td><td>Analyze the network topology. If there are changes in the model, Analyze updates the netlist and the load flow input data.</td></tr><tr><td><strong>Load Flow</strong></td><td><p>Execute the load flow analysis, a short load flow report will be returned to the log. This step also sets initial conditions to all the buses and components in the model.</p><p>The <strong>Execute Load Flow</strong> function automatically executes the <strong>Analyze</strong> function.</p></td></tr><tr><td><strong>Set initial conditions</strong></td><td>This is to Initialize conditions at the simulation start. Therefore, the simulation will start from a steady-state condition.</td></tr><tr><td><strong>XML Report</strong></td><td>Display Load Flow report as XML file in the Report Tab</td></tr><tr><td><strong>Txt Report</strong></td><td>Display Load Flow report as text file in the Output tab</td></tr></tbody></table>
{% endtab %}

{% tab title="Parameters" %}

<table data-search="false"><thead><tr><th width="200">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Frequency (Hz)</strong></td><td>The nominal frequency of the power system model.</td></tr><tr><td><strong>Power base (MVA)</strong></td><td>The power base when displaying power in PU.</td></tr><tr><td><strong>PQ tolerance (MVA)</strong></td><td>The load flow convergence tolerance.</td></tr><tr><td><strong>Max iterations</strong></td><td>The maximum number of iterations for the load flow algorithm to search for a convergent solution.</td></tr><tr><td><strong>Deceleration factor</strong></td><td>Usually set to 1 for most cases, this parameter is used only when iteration is necessary to find a solution. Decreasing its value reduces the size of the variation between two iterations.</td></tr><tr><td><strong>Use Qmin and Qmax limits</strong></td><td>If this option is checked, the Q limits specified in each component's load flow tab are used as constraints when solving the load flow equations.</td></tr></tbody></table>
{% endtab %}

{% tab title="Report & Output section" %}

<table data-search="false"><thead><tr><th width="200">Report &#x26; Output Section</th><th>Description</th></tr></thead><tbody><tr><td><strong>Display Options > units</strong></td><td><ul><li>pu Voltage: Display the voltage in PU according to the base voltages.</li><li>pu Power: Display the power in PU according to the Power base.</li></ul></td></tr><tr><td><strong>Display Options > digits</strong></td><td>The number of digits after the decimal points can be adjusted between 3, 6, 9 and 12, to show more precise results.</td></tr><tr><td><strong>Output</strong></td><td><p>This tab displays the parameters used to calculate the loadflow wit the following sections:</p><ul><li><strong>Bus summary</strong> → nominal voltages</li><li><strong>Generation summary</strong> → generator types and outputs</li><li><strong>Shunt impedance summary</strong> → load and admittance contributions</li><li><strong>Bus report</strong> → detailed per-bus power flows</li><li><strong>Generation report</strong> → generator electrical quantities</li><li><strong>System summary</strong> → total generation, load, and mismatch</li></ul></td></tr></tbody></table>
{% endtab %}
{% endtabs %}

The **Load\_Flow\.ecf** example is used throughout this procedure to illustrate the load-flow configuration and initialization steps.Before running the load-flow analysis, complete the necessary [model preparation](https://www.opal-rt.com/docs/hypersim/model-and-simulation/prepare-the-simulation/run-load-flow-analysis/prepare-the-model-for-load-flow.md) steps to ensure correct load-flow initialization.

## Run the load flow

{% stepper %}
{% step %}

### Analyze the network (optional)

Click **Analyze** to check the network topology, update the netlist and refresh the load flow input data if the model has changed. Use this when the network was modified after the last analysis.

{% hint style="info" %}
The **Load Flow** execution automatically performs this step if needed. You do not need to click Analyze manually in most cases.
{% endhint %}
{% endstep %}

{% step %}

### Set load flow options

Before running the load flow, review and adjust the **parameters.**
{% endstep %}

{% step %}

### Execute the load flow

Click the **Load Flow** button to execute the load flow analysis, compute the steady-state solution, and apply results to the model.

A summary of the load flow results is displayed in the Output tab.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-c5a33e5563f161f00c6dad0e519b20215690b34c%2Fload-flow-output-example.png?alt=media" alt=""><figcaption></figcaption></figure>

Click on the **XML Report** button in the menu to generate and save the Report. The Report tab is displayed.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-2c9673c7f576dd963137d7b5a4061399562ef566%2Fload-flow-data-computed.png?alt=media" alt=""><figcaption></figcaption></figure>

<details>

<summary>Output report</summary>

{% code overflow="wrap" lineNumbers="true" %}

```

====================  Bus summary  ====================
Bus    Vbase (kV rms LL)
Bus1             230.000
Bus10            230.000
Bus11            230.000
Bus12            230.000
Bus13            230.000
Bus14             13.800
Bus15             13.800
Bus16             13.800
Bus2             110.000
Bus3             110.000
Bus4             110.000
Bus5             110.000
Bus5_1           110.000
Bus6             110.000
Bus7             110.000
Bus8             110.000
Bus9             230.000
Total: 17 buses 

====================  Generation summary  ====================
Bus                  Component            Type           V (kV rms LL, deg)                    P (MW)          Q (Mvar)       Qmin (Mvar)       Qmax (Mvar)
Bus1                 VS1                  PV                230.000   -----                     0.000             -----          -999.000           999.000
Bus13                VS2                  Swing             230.000 @ 0.000                     -----             -----          -999.000           999.000
Bus14                SM2                  PV                 13.800   -----                    30.000             -----          -999.000           999.000
Bus15                SM3                  PV                 13.800   -----                    30.000             -----          -999.000           999.000
Bus16                SM1                  PV                 13.800   -----                    30.000             -----          -999.000           999.000
                                                                                         ------------      ------------
Total [    5 generator(s)]:                                                                    90.000             0.000


====================  Shunt impedance summary  ====================
Bus                  Component            Vbase (kV rms LL)        P (MW)      Q (Mvar)            
Bus10                Load_10                        230.000        19.980        -0.000
Bus11                Load_11                        230.000        19.980        -0.000
Bus14                Snubber_14                      13.800         0.990        -9.991
Bus15                Snubber_15                      13.800         0.990        -9.991
Bus16                Snubber_16                      13.800         0.990        -9.991
Bus7                 Load_7                         110.000        19.985        -0.000
Bus9                 Load_9                         230.000        19.980        -0.000
                                                             ------------  ------------
Total [    7 element(s)]:                                          82.896       -29.973


===========================================================================================================================================


====================  Bus report  ====================
Node Bus1 (no 0)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               230.000 @ 3.474                 0.000       -56.255         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus1        Bus2        Tr1             -36.123        -6.094
Bus1        Bus9        L1_2             35.370       -50.762

Node Bus10 (no 1)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               240.098 @ 0.556                 0.000         0.000         0.000         0.000        21.773         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus10       Bus11       L1_7             20.805       -18.504
Bus10       Bus9        L1_5            -42.578        18.504

Node Bus11 (no 2)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               240.687 @ -0.174                0.000         0.000         0.000         0.000        21.880        -0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus11       Bus10       L1_7            -20.793        -9.013
Bus11       Bus12       L1_8             -1.088         9.013

Node Bus12 (no 3)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               237.347 @ -0.107                0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus12       Bus11       L1_8              1.101       -36.172
Bus12       Bus13       L1_9             -1.101        36.172

Node Bus13 (no 4)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               230.000 @ 0.000                 1.159       -60.900         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus13       Bus12       L1_9              1.159       -60.900

Node Bus14 (no 5)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
                13.800 @ 12.859               30.000       -18.019         0.000         0.000         0.990        -9.991
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus14       Bus7        Tr3              28.395        -8.628

Node Bus15 (no 6)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
                13.800 @ 15.175               30.000       -16.303         0.000         0.000         0.990        -9.991
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus15       Bus8        Tr4              28.400        -6.912

Node Bus16 (no 7)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
                13.800 @ 34.487               30.000       -25.317         0.000         0.000         0.990        -9.991
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus16       Bus9        Tr2              28.318       -15.926

Node Bus2 (no 8)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.156 @ -23.452               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus2        Bus1        Tr1              36.123         8.107
Bus2        Bus3        BR1             -24.014        -2.415
Bus2        Bus4        BR2             -12.108        -5.692

Node Bus3 (no 9)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.156 @ -23.452               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus3        Bus2        BR1              24.014         2.415
Bus3        Bus5        L1_1            -24.014        -2.415

Node Bus4 (no 10)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.156 @ -23.452               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus4        Bus2        BR2              12.108         5.692
Bus4        Bus5_1      L1_6            -12.108        -5.692

Node Bus5 (no 11)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.512 @ -19.549               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus5        Bus3        L1_1             24.074        -1.907
Bus5        Bus7        BR3             -24.074         1.907

Node Bus5_1 (no 12)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               112.217 @ -21.515               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus5_1      Bus4        L1_6             12.125         0.130
Bus5_1      Bus6        L1_4            -12.125        -0.130

Node Bus6 (no 13)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.513 @ -19.549               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus6        Bus5_1      L1_4             12.141        -5.456
Bus6        Bus7        BR4             -12.141         5.456

Node Bus7 (no 14)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.513 @ -19.549               0.000         0.000         0.000         0.000        20.539        -0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus7        Bus14       Tr3             -28.395         9.950
Bus7        Bus5        BR3              24.074        -1.907
Bus7        Bus6        BR4              12.141        -5.456
Bus7        Bus8        L1_3            -28.358        -2.587

Node Bus8 (no 15)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               111.230 @ -17.240               0.000         0.000         0.000         0.000         0.000         0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus8        Bus15       Tr4             -28.400         8.193
Bus8        Bus7        L1_3             28.400        -8.193

Node Bus9 (no 16)
Summary
             V (kV rms LL, deg)            Pgen (MW)   Qgen (Mvar)    Pload (MW)  Qload (Mvar)   Pshunt (MW) Qshunt (Mvar)
               235.678 @ 2.111                 0.000         0.000         0.000         0.000        20.979        -0.000
Detail
Source      Destination Component        P (MW)      Q (Mvar)            
Bus9        Bus1        L1_2            -35.303        26.473
Bus9        Bus10       L1_5             42.643       -43.983
Bus9        Bus16       Tr2             -28.318        17.510


====================  Generation report  ====================
Bus                  Component            Type          Vbase (kV rms LL)            V (kV rms LL, deg)              P (MW)      Q (Mvar)         Vint (kV rms LL, deg)                 I (kA peak LG, deg)    
Bus1                 VS1                  PV                      230.000             230.000 @ 3.474                 0.000       -56.255             228.471 @ 3.529                       0.200 @ 93.474       
Bus13                VS2                  Swing                   230.000             230.000 @ 0.000                 1.159       -60.900             228.350 @ 0.067                       0.216 @ 88.910       
Bus14                SM2                  PV                       13.800              13.800 @ 12.859               30.000       -18.019              13.374 @ 15.873                      2.071 @ 43.850       
Bus15                SM3                  PV                       13.800              13.800 @ 15.175               30.000       -16.303              13.417 @ 18.180                      2.020 @ 43.696       
Bus16                SM1                  PV                       13.800              13.800 @ 34.487               30.000       -25.317              13.193 @ 37.541                      2.323 @ 74.648       
                                                                                                               ------------  ------------
Total [    5 generator(s)]:                                                                                          91.159      -176.795


====================  Shunt report  ====================
Bus                  Component              Vbase (kV rms LL)           V (kV rms LL, deg)               P (MW)      Q (Mvar)
Bus10                Load_10                          230.000             240.098 @ 0.556                21.773         0.000
Bus11                Load_11                          230.000             240.687 @ -0.174               21.880        -0.000
Bus14                Snubber_14                        13.800              13.800 @ 12.859                0.990        -9.991
Bus15                Snubber_15                        13.800              13.800 @ 15.175                0.990        -9.991
Bus16                Snubber_16                        13.800              13.800 @ 34.487                0.990        -9.991
Bus7                 Load_7                           110.000             111.513 @ -19.549              20.539        -0.000
Bus9                 Load_9                           230.000             235.678 @ 2.111                20.979        -0.000
                                                                                                   ------------  ------------
Total [    7 elements(s)]:                                                                               88.141       -29.973



============================  Summary  ============================
                                 P (MW)            Q (Mvar)      
Generation total                91.159            -176.795
Load total                       0.000               0.000
Shunt total                     88.141             -29.973
Difference                       3.018            -146.821


===========================================================================================================================================
```

{% endcode %}

</details>

{% hint style="info" %}
If mistakes were made while entering input parameters for various circuit components (e.g. wrong voltage for a three-phase bus), an error message appears. When the user attempts to execute the load flow, it warns the user that input parameters are not correct and indicates which parameters are at fault.
{% endhint %}

After running the load flow, double-click for example *VS1* to view the updated voltage magnitude and angle, or *SM1* to view the updated active and reactive power.
{% endstep %}

{% step %}

### Apply load flow results to simulation

Click **Set Initial Conditions** button to initialize the simulation from the load flow solution.

This action copies the computed steady-state values into the model so that the simulation starts from those conditions.

The load flow parameters can also be viewed in **Netlist** - **Load Flow Parameters**.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
To get the software to automatically run a load flow analysis before the start of the simulation, click on **set initial conditions** in the load flow window.
{% endhint %}


---

# 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/prepare-the-simulation/run-load-flow-analysis/run-the-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.
