> 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/simulation-and-analysis/load-flow-bus.md).

# Load Flow Bus

## Description

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

The **Load Flow Bus** block, located in the **OPAL-RT SPS Software/Utilities** library, identifies and parameterizes load flow bus.

You use the Load Flow Bus block in models to specify the bus locations and parameters to solve a load flow. The Powergui Load Flow tool solves the load flow. SPS allows you to perform two types of load flows:

* Positive-sequence load flow applied to a three-phase system. Positive-sequence voltages as well as active power (P) and reactive power (Q) flows are computed at each three-phase bus.
* Unbalanced load flow applied to a mix of three-phase, two-phase, and single-phase systems. Individual phase voltage and PQ flow are computed for each phase.

To perform a positive-sequence load flow, you must define all of the Load Flow Bus blocks in your model with the **Connectors** parameter set to single. For this type of load flow, the load flow blocks are:

* Asynchronous Machine
* Simplified Synchronous Machine
* Synchronous Machine
* Three-Phase Dynamic Load
* Three-Phase Parallel RLC Load
* Three-Phase Programmable Voltage Source
* Three-Phase Series RLC Load
* Three-Phase Source

To perform an unbalanced load flow, you must define all of the Load Flow Bus blocks in your model with the **Connectors** parameter set to one of the following values: ABC, AB, AC, BC, A, B, or C. For an unbalanced load flow, the load flow blocks are:

* AC Voltage Source
* Asynchronous Machine
* Parallel RLC Load
* Series RLC Load
* Synchronous Machine
* Three-Phase Dynamic Load
* Three-Phase Parallel RLC Load
* Three-Phase Series RLC Load
* Three-Phase Source

The Powergui Load Flow tool reports an error if a model contains a mix of Load Flow Bus blocks set to perform a positive-sequence load flow and Load Flow Bus blocks set to perform an unbalanced load flow.

When several load flow blocks are connected together at the same bus, only one Load Flow Bus block is required. You can also connect the Load Flow Bus block at a location where you are interested in monitoring the load flow, even if no load flow blocks are connected at that location.

### Implicit Buses (for Positive-Sequence Load Flow Only)

If you omit to connect a Load Flow Bus block to a load flow block, the Load Flow tool will automatically define an implicit (internal) load flow bus for that block. The bus base voltage of this implicit bus is set to the same value as the nominal voltage of the load flow block. When several load flow blocks are connected together, one nominal voltage is arbitrarily selected among the blocks.

Although the Load Flow tool can perform load flow on a model with no Load Flow Bus block in the model (working only with implicit buses), the recommended practice is to connect a Load Flow Bus block everywhere a load flow block exists.

## Ports

### Conserving

<table data-header-hidden><thead><tr><th width="249.77783203125"></th><th></th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A connector<br>SPS electrical</td><td><p>SPS electrical conserving port associated with the phase A connector.</p><p>If you set the <strong>Configuration</strong> parameter to on both sides, this port appears twice.</p><p><strong>Dependencies</strong> To enable this port, set <strong>Connectors</strong> to ABC, AB, AC, or A.</p></td></tr><tr><td><strong>B</strong> — Phase B connector<br>SPS electrical</td><td><p>SPS electrical conserving port associated with the phase B connector.</p><p>If you set the <strong>Configuration</strong> parameter to on both sides, this port appears twice.</p><p><strong>Dependencies</strong> To enable this port, set <strong>Connectors</strong> to ABC, AB, BC, or B.</p></td></tr><tr><td><strong>C</strong> — Phase C connector<br>SPS electrical</td><td><p>SPS electrical conserving port associated with the phase C connector.</p><p>If you set the <strong>Configuration</strong> parameter to on both sides, this port appears twice.</p><p><strong>Dependencies</strong> To enable this port, set <strong>Connectors</strong> to ABC, BC, AC, or C.</p></td></tr></tbody></table>

## Parameters

The Load Flow Bus parameters are used for model initialization only. They have no impact on the simulation performance.

{% hint style="info" %}
The bus type (PV, PQ, or swing) is not defined in the mask of the Load Flow Bus block. You can have several machines and voltage source blocks with different generator type parameters connected at the same bus. The Load Flow tool determines the resulting bus type.
{% endhint %}

To edit block parameters interactively, use the Property Inspector. From the Simulink<sup>®</sup> Toolstrip, on the **Simulation** tab, in the **Prepare** gallery, select **Property Inspector**.

<table data-header-hidden><thead><tr><th width="260.5555419921875"></th><th></th></tr></thead><tbody><tr><td><strong>Connectors</strong> — Block connectors<br>single (default) | ABC | AB | AC | BC | A | B | C</td><td><p>Set to single (default) when you perform a positive-sequence load flow.</p><p>You connect a Load Flow Bus block to any phase (A, B, or C) of every load flow block in the model. The icon of the block displays the number 3, indicating that the block is defined to perform a positive-sequence load flow.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-8cbb94cb601035d3c37665a4033513673c505047%2Fload_flow_bus_connector.png?alt=media" alt="" data-size="original"></p><p>When you perform an unbalanced load flow, you connect a Load Flow Bus block to all phases of every load flow block in the model. Depending on the number of phases, you need to specify the appropriate Connectors parameter by selecting one of these connector combinations:</p><ul><li>Three connectors: ABC</li><li>Two connectors: AB, AC, or BC</li><li>A single connector : A, B, or C</li></ul><p>The figure shows examples of Load Flow Bus blocks set to define different phases of a given model, to perform an unbalanced load flow.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-df208dfaf4f4c2d16154dba2c73317091cd39a49%2Fload_flow_bus_connector2.png?alt=media" alt="" data-size="original"></p></td></tr><tr><td><strong>Configuration</strong> — Configuration options<br>on one side (default) | on both sides</td><td><p>When the <strong>Configuration</strong> parameter is set to on one side, the block displays the block phase ports only on one side of the block.</p><p>You can connect the Load Flow Bus block anywhere in the model to identify a connection line as a load flow bus:</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-939060a900c3ec01ac750f71cf8fcb7b46636599%2Fload_flow_bus_configuration.png?alt=media" alt="" data-size="original"></p><p>When the <strong>Configuration</strong> parameter is set to on both sides, the block displays the block phase ports on both sides of the block.</p><p>You can connect the Load Flow Bus block in series with other Simscape Electrical SPS blocks to identify a connection line as a load flow bus.</p><p><img src="https://799605156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdlNg8IbOdahCpFCyzxSN%2Fuploads%2Fgit-blob-07eead9d503dad928dce0fd117d8bbe3f87a6f2d%2Fload_flow_bus_configuration2.png?alt=media" alt="" data-size="original"></p><p>Both options perform the same action, and you can seamlessly use either method to connect the Load Flow Bus blocks.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr><tr><td><strong>Bus Identification</strong> — Bus label<br>BUS_1 (default) | character vector</td><td><p>Alphanumeric label.</p><p>The <strong>Bus Identification</strong> label appears below the block as a block annotation.</p></td></tr><tr><td><strong>Base voltage (Vrms phase-phase)</strong> — Base voltage (Vrms phase-phase)<br>25e3</td><td><p>Base voltage is usually the same as the nominal voltage of the load flow blocks connected to the Load Flow Bus block.</p><p>The <strong>Base voltage</strong> values appears below the block as a block annotation.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to single.</p></td></tr><tr><td><strong>Swing bus or PV bus voltage (pu)</strong> — Required bus voltage magnitude<br>1 (default)</td><td><p>Required bus voltage magnitude, in pu. Depending on the bus type of the load flow blocks connected at that bus, this voltage corresponds to the swing bus voltage or the PV bus voltage.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to single.</p></td></tr><tr><td><strong>Swing bus voltage angle (degrees)</strong> — Swing bus voltage angle<br>0 (default)</td><td><p>Swing bus voltage angle is used as a reference to compute voltage angles of all other buses in the model.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to single.</p></td></tr><tr><td><strong>Base voltage (Vrms phase-ground)</strong> — Base voltage (Vrms phase-ground)<br>25e3 (default)</td><td><p>Base voltage is usually the same as the nominal voltage of the load flow blocks connected to the Load Flow Bus block.</p><p>The <strong>Base voltage</strong> values appears below the block as a block annotation.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to single.</p></td></tr><tr><td><strong>Swing bus or PV bus voltage, per phase (pu)</strong> — Required bus voltage magnitude for every phase<br>1 (default)</td><td><p>Specify the required bus voltage magnitude, in pu, for every phase specified by the <strong>Connectors</strong> parameter.</p><p>Depending on the bus type of the load flow blocks connected at that bus, this voltage corresponds to the swing bus voltage or the PV bus voltage.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr><tr><td><strong>Swing bus voltage angle, per phase (degrees)</strong> — Required bus voltage angle for every phase<br>0 (default)</td><td><p>Required bus voltage angle, in pu, for every phase specified by the <strong>Connectors</strong> parameter.</p><p>The swing bus voltage angles are used as a reference to compute voltage angles of all other buses in the model.</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr></tbody></table>

### Load Flow

#### **Bus voltage section**

<table data-header-hidden><thead><tr><th width="249.77777099609375"></th><th></th></tr></thead><tbody><tr><td><strong>Phase A</strong> — Resulting bus voltage of phase A<br>1 (default)</td><td><p>Displays the resulting bus voltage of phase A, in pu, once the load flow is solved. This parameter appears dimmed because it is updated by the Load Flow tool.</p><p>The parameter value appears below the block as a block annotation.</p><p>The value is set to NaN by the Load Flow tool when the load flow solution is not computed for this phase (that is, when the <strong>Connectors</strong> parameter is set to BC, B, or C).</p></td></tr><tr><td><strong>Phase B</strong> — Resulting bus voltage of phase B<br>1 (default)</td><td><p>Displays the resulting bus voltage of phase B, in pu, once the load flow is solved.</p><p>This parameter appears dimmed because it is updated by the Load Flow tool.</p><p>The parameter value appears below the block as a block annotation.</p><p>The value is set to NaN by the Load flow tool when the load flow solution is not computed for this phase (that is, when the <strong>Connectors</strong> parameter is set to AC, A, or C).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr><tr><td><strong>Phase C</strong> — Resulting bus voltage of phase C<br>1 (default)</td><td><p>Displays the resulting bus voltage of phase C, in pu, once the load flow is solved.</p><p>This parameter appears dimmed because it is updated by the Load Flow tool.</p><p>The parameter value appears below the block as a block annotation.</p><p>The value is set to NaN by the Load flow tool when the load flow solution is not computed for this phase (that is, when the <strong>Connectors</strong> parameter is set to AB, A, or B).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr></tbody></table>

#### **Bus angle section**

<table data-header-hidden><thead><tr><th width="249.66668701171875"></th><th></th></tr></thead><tbody><tr><td><strong>Phase A</strong> — Resulting bus voltage angle of phase A<br>0 (default)</td><td><p>Displays the resulting bus voltage angle of phase A, in pu, once the load flow is solved. This parameter appears dimmed because it is updated by the Load Flow tool.</p><p>The parameter value appears below the block as a block annotation.</p><p>The value is set to NaN by the Load Flow tool when the load flow solution is not computed for this phase (that is, when the <strong>Connectors</strong> parameter is set to BC, B, or C).</p></td></tr><tr><td><strong>Phase B</strong> — Resulting bus voltage angle of phase B<br>0 (default)</td><td><p>Displays the resulting bus voltage angle of phase B, in pu, once the load flow is solved. This parameter appears dimmed because it is updated by the Load Flow tool.</p><p>The parameter value appears below the block as a block annotation.</p><p>The value is set to NaN by the Load flow tool when the load flow solution is not computed for this phase (that is, when the <strong>Connectors</strong> parameter is set to AC, A, or C).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr><tr><td><strong>Phase C</strong> — Resulting bus voltage angle of phase C<br>0 (default)</td><td><p>Displays the resulting bus voltage angle of phase C, in pu, once the load flow is solved. This parameter appears dimmed because it is updated by the Load Flow tool.</p><p>The parameter value appears below the block as a block annotation.</p><p>The value is set to NaN by the Load flow tool when the load flow solution is not computed for this phase (that is, when the <strong>Connectors</strong> parameter is set to AB, A, or B).</p><p><strong>Dependencies</strong> To enable this parameter, set <strong>Connectors</strong> to ABC, AB, AC, BC, A, B, or C.</p></td></tr></tbody></table>

## Examples

The [Synchronous Machine](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/machines/synchronous-machine.md) (power\_turbine) example contains two Load Flow Bus blocks. The B1 block is connected to the 5 MW Three-Phase Parallel RLC Load and to the Synchronous Machine load flow blocks. The B2 block is connected to the 10 MW Three-Phase Parallel RLC Load and to the Three-Phase Source load flow blocks.

The two blocks display the bus voltages and angles resulting from a load flow solution previously saved with the model. The bus voltage at bus B1 displays 1 pu, -23.67 deg. Start the simulation, verify it starts in steady state, then zoom on the initial value of the measured voltage Va. You should read an initial voltage of about -0.4015 pu. At the MATLAB® command prompt, compute the angle of the measured voltage:

{% code lineNumbers="true" %}

```matlab
asin(-0.4015)*180/pi 

ans = 
        -23.672
```

{% endcode %}

You can also take a look at the [Initializing a 5-Bus Network with the Load Flow Tool of Powergui](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/simulation-and-analysis/initializing-a-5-bus-network-with-the-load-flow-tool-of-powergui.md) (power\_LFnetwork\_5bus) model. In this model five Load Flow Bus blocks are used. The block labeled B120 is the swing bus.

The [IEEE 13 Node Test Feeder](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/simulation-and-analysis/ieee-13-node-test-feeder.md) (power\_13NodeTestFeeder) example contains Load Flow Bus blocks set to perform an unbalanced load flow for a 13-node test feeder IEEE benchmark model.


---

# 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/simulation-and-analysis/load-flow-bus.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.
