> 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/rt-lab/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/native-library-components/load-components.md).

# Load Components

## Positive-sequence network <a href="#parameters" id="parameters"></a>

In a **positive-sequence network**, three static load models and one dynamic load model can be used:

* **Constant Impedance Load**
* **Constant Current Load**
* **Constant Power Load**
* **Dynamic Load**

All load models are connected to a single bus and are defined by their active and reactive power demand.

### Constant impedance load

A constant impedance load maintains a fixed impedance. The active and reactive power consumed by the load vary with the square of the bus voltage magnitude.

| Excel Column Name | Native Component Parameter | Description                                                                                            |
| ----------------- | -------------------------- | ------------------------------------------------------------------------------------------------------ |
| **ID**            | `name`                     | Load identifier.                                                                                       |
| **Status**        | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p>          |
| **Bus**           | `bus`                      | Bus to which the load is connected.                                                                    |
| **P (MW)**        | `active_power`             | Active power demand at 1 pu voltage.                                                                   |
| **Q (MVAr)**      | `reactive_power`           | Reactive power demand at 1 pu voltage. Positive for inductive loads and negative for capacitive loads. |

### Constant current load

A constant current load maintains a fixed current magnitude. The active and reactive power consumed by the load vary proportionally with the bus voltage magnitude.

| Excel Column Name | Native Component Parameter | Description                                                                                   |
| ----------------- | -------------------------- | --------------------------------------------------------------------------------------------- |
| **ID**            | `name`                     | Load identifier.                                                                              |
| **Status**        | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p> |
| **Bus**           | `bus`                      | Bus to which the load is connected.                                                           |
| **P (MW)**        | `power_re`                 | Active power demand.                                                                          |
| **Q (MVAr)**      | `power_im`                 | Reactive power demand. Positive for inductive loads and negative for capacitive loads.        |

### Constant power load

A constant power load maintains a fixed active and reactive power demand regardless of the bus voltage magnitude.

| Excel Column Name | Native Component Parameter | Description                                                                                   |
| ----------------- | -------------------------- | --------------------------------------------------------------------------------------------- |
| **ID**            | `name`                     | Load identifier.                                                                              |
| **Status**        | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p> |
| **Bus**           | `bus`                      | Bus to which the load is connected.                                                           |
| **P (MW)**        | `power_re`                 | Active power demand.                                                                          |
| **Q (MVAr)**      | `power_im`                 | Reactive power demand. Positive for inductive loads and negative for capacitive loads.        |

### Dynamic load

The Dynamic Load component implements an exponential load model based on the *IEEE Guide for Load Modeling and Simulations for Power Systems*. More details can be found in [Dynamic Load Model](https://www.opal-rt.com/docs/rt-lab/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/native-library-components/load-components/dynamic-load-model.md) section.

During load-flow calculations, frequency-dependent behavior is ignored because the system frequency is assumed constant.

| Excel Column Name | Native Component Parameter | Description                                                                                   |
| ----------------- | -------------------------- | --------------------------------------------------------------------------------------------- |
| **ID**            | `name`                     | Load identifier.                                                                              |
| **Status**        | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p> |
| **Bus**           | `bus`                      | Bus to which the load is connected.                                                           |
| **P**             | `power_re`                 | Rated active power demand (MW).                                                               |
| **Q**             | `power_im`                 | Rated reactive power demand (MVAr).                                                           |
| **kp1**           | `kp1`                      | First voltage-dependence coefficient for active power (%).                                    |
| **kp2**           | `kp2`                      | Second voltage-dependence coefficient for active power (%).                                   |
| **kp3**           | `kp3`                      | Third voltage-dependence coefficient for active power (%).                                    |
| **ep**            | `ep1`                      | First voltage-dependence exponent for active power.                                           |
| **ep2**           | `ep2`                      | Second voltage-dependence exponent for active power.                                          |
| **ep3**           | `ep3`                      | Third voltage-dependence exponent for active power.                                           |
| **kq1**           | `kq1`                      | First voltage-dependence coefficient for reactive power (%).                                  |
| **kq2**           | `kq2`                      | Second voltage-dependence coefficient for reactive power (%).                                 |
| **kq3**           | `kq3`                      | Third voltage-dependence coefficient for reactive power (%).                                  |
| **eq1**           | `eq1`                      | First voltage-dependence exponent for reactive power.                                         |
| **eq2**           | `eq2`                      | Second voltage-dependence exponent for reactive power.                                        |
| **eq3**           | `eq3`                      | Third voltage-dependence exponent for reactive power.                                         |
| **KPfreq**        | `kpfreq`                   | Frequency sensitivity coefficient for active power.                                           |
| **KQfreq**        | `kqfreq`                   | Frequency sensitivity coefficient for reactive power.                                         |
| **v0**            | `v0`                       | Nominal operating voltage (pu).                                                               |
| **range**         | `range`                    | Width of the voltage operating range around the nominal voltage (pu).                         |
| **t1**            | `t1`                       | Load response delay (s).                                                                      |
| **tpv**           | `tpv`                      | Voltage-dependence time constant for active power (s).                                        |
| **tqv**           | `tqv`                      | Voltage-dependence time constant for reactive power (s).                                      |
| **tpf**           | `tpf`                      | Frequency-dependence time constant for active power (s).                                      |
| **tqf**           | `tqf`                      | Frequency-dependence time constant for reactive power (s).                                    |

## Multiphase network <a href="#parameters" id="parameters"></a>

In a **multiphase network**, three multiphase ZIP load components can be used:

* **Single-Phase ZIP Load**
* **Two-Phase ZIP Load**
* **Three-Phase ZIP Load**

A ZIP load is a combination of **constant impedance (Z)**, **constant current (I)**, and **constant power (P)** load models. The user specifies the contribution of each component using the coefficients **Kz**, **Ki**, and **Kp**. Each phase can be assigned independent active and reactive power values.

{% hint style="info" %}

* The ZIP coefficients must satisfy: **Kz**+**Ki**+**Kp**=**1**
* For **constant-current** and **constant-power** portions of the ZIP model, if the bus voltage falls below 1−Bandwidth pu or exceeds 1+Bandwidth pu, the load is automatically converted to an equivalent constant-impedance load.
* Only **grounded wye (Yg)** connections are currently supported in power-flow calculations.
* When **Use initial voltage?** is enabled, the specified powers are interpreted using the initial bus voltage instead of the nominal voltage.
  {% endhint %}

### Single-phase ZIP load

A single-phase ZIP load is connected to a single phase-specific bus.

| Excel Column Name        | Native Component Parameter | Description                                                                                                                            |
| ------------------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **ID**                   | `name`                     | Load identifier.                                                                                                                       |
| **Status**               | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p>                                          |
| **V (kV)**               | `vll`                      | Nominal line-to-line voltage.                                                                                                          |
| **Bandwidth (pu)**       | `range`                    | Voltage threshold used to convert constant-current and constant-power behavior to constant-impedance behavior.                         |
| **Conn. type**           | `mode`                     | Connection type (`wye` or `delta`).                                                                                                    |
| **K\_z**                 | `z_coef`                   | Constant-impedance fraction.                                                                                                           |
| **K\_i**                 | `i_coef`                   | Constant-current fraction.                                                                                                             |
| **K\_p**                 | `p_coef`                   | Constant-power fraction.                                                                                                               |
| **Use initial voltage?** | `use_initial_voltage`      | Uses the initial bus voltage instead of the nominal voltage when initializing the load (`0` = nominal voltage, `1` = initial voltage). |
| **Bus1**                 | `buses`                    | Connected phase bus identifier.                                                                                                        |
| **P1 (kW)**              | `power_re`                 | Active power demand for phase 1.                                                                                                       |
| **Q1 (KVar)**            | `power_im`                 | Reactive power demand for phase 1.                                                                                                     |

### Two-phase ZIP load

A two-phase ZIP load is connected to two phase-specific buses.

| Excel Column Name        | Native Component Parameter | Description                                                                                                                            |
| ------------------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **ID**                   | `name`                     | Load identifier.                                                                                                                       |
| **Status**               | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p>                                          |
| **V (kV)**               | `vll`                      | Nominal line-to-line voltage.                                                                                                          |
| **Bandwidth (pu)**       | `range`                    | Voltage threshold used to convert constant-current and constant-power behavior to constant-impedance behavior.                         |
| **Conn. type**           | `mode`                     | Connection type (`wye` or `delta`).                                                                                                    |
| **K\_z**                 | `z_coef`                   | Constant-impedance fraction.                                                                                                           |
| **K\_i**                 | `i_coef`                   | Constant-current fraction.                                                                                                             |
| **K\_p**                 | `p_coef`                   | Constant-power fraction.                                                                                                               |
| **Use initial voltage?** | `use_initial_voltage`      | Uses the initial bus voltage instead of the nominal voltage when initializing the load (`0` = nominal voltage, `1` = initial voltage). |
| **Bus1, Bus2**           | `buses`                    | Connected phase bus identifiers.                                                                                                       |
| **P1, P2 (kW)**          | `power_re`                 | Active power demand for phases 1 and 2.                                                                                                |
| **Q1, Q2 (KVar)**        | `power_im`                 | Reactive power demand for phases 1 and 2.                                                                                              |

### Three-Phase ZIP Load

A three-phase ZIP load is connected to three phase-specific buses.

| Excel Column Name        | Native Component Parameter | Description                                                                                                                            |
| ------------------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **ID**                   | `name`                     | Load identifier.                                                                                                                       |
| **Status**               | `status`                   | <p>Initial service status.<br><code>1</code> = connected<br><code>0</code> = disconnected</p>                                          |
| **V (kV)**               | `vll`                      | Nominal line-to-line voltage.                                                                                                          |
| **Bandwidth (pu)**       | `range`                    | Voltage threshold used to convert constant-current and constant-power behavior to constant-impedance behavior.                         |
| **Conn. type**           | `mode`                     | Connection type (`wye` or `delta`).                                                                                                    |
| **K\_z**                 | `z_coef`                   | Constant-impedance fraction.                                                                                                           |
| **K\_i**                 | `i_coef`                   | Constant-current fraction.                                                                                                             |
| **K\_p**                 | `p_coef`                   | Constant-power fraction.                                                                                                               |
| **Use initial voltage?** | `use_initial_voltage`      | Uses the initial bus voltage instead of the nominal voltage when initializing the load (`0` = nominal voltage, `1` = initial voltage). |
| **Bus1, Bus2, Bus3**     | `buses`                    | Connected phase bus identifiers.                                                                                                       |
| **P1, P2, P3 (kW)**      | `power_re`                 | Active power demand for phases 1-3.                                                                                                    |
| **Q1, Q2, Q3 (KVar)**    | `power_im`                 | Reactive power demand for phases 1-3.                                                                                                  |


---

# 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/rt-lab/model-and-simulation/phasor-domain-with-ephasorsim/integrate-a-power-system-model-to-ephasorsim/native-library-components/load-components.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.
