> 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/basics/passives/three-phase-dynamic-load.md).

# Three-Phase Dynamic Load

## Description

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

The **Three-Phase Dynamic Load** block, located in the **OPAL-RT SPS Software/Passives** library, implements a three-phase, three-wire dynamic load whose active power P and reactive power Q vary as function of positive-sequence voltage. Negative- and zero-sequence currents are not simulated. The three load currents are therefore balanced, even under unbalanced load voltage conditions.

The load impedance is kept constant if the terminal voltage V of the load is lower than a specified value Vmin. When the terminal voltage is greater than the Vmin value, the active power P and reactive power Q of the load vary as follows:

$$
\begin{aligned}
P(s) &= P\_0 \left( \frac{V}{V\_0} \right)^{n\_p}
\frac{1 + T\_{p1}s}{1 + T\_{p2}s}, \\\[8pt]
Q(s) &= Q\_0 \left( \frac{V}{V\_0} \right)^{n\_q}
\frac{1 + T\_{q1}s}{1 + T\_{q2}s}.
\end{aligned}
$$

where

* $$V\_0$$ is the initial positive sequence voltage.
* $$P\_0$$ and $$Q\_0$$ are the initial active and reactive powers at the initial voltage Vo.
* V is the positive-sequence voltage.
* $$n\_p$$ and $$n\_q$$ are exponents (usually between 1 and 3) controlling the nature of the load.
* $$T\_{p1}$$ and $$T\_{p2}$$ are time constants controlling the dynamics of the active power P.
* $$T\_{q1}$$ and $$T\_{q2}$$ are time constants controlling the dynamics of the reactive power Q.

For a constant current load, for example, you set to 1 and to 1, and for constant impedance load you set $$n\_p$$ to 1 and $$n\_q$$ to 1 and for constant impedance load you set $$n\_p$$ to 2 and $$n\_q$$ to 2.

## Ports

### Input

<table><thead><tr><th width="249.99993896484375">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>PQ</strong> — Control for active and reactive power (vector of two elements)</td><td>Control for the active and reactive powers of the load, specified as a vector of two signals [P, Q]. <strong>Dependencies:</strong> To enable this port, select the <strong>External control of PQ</strong> parameter.</td></tr></tbody></table>

### Output

<table><thead><tr><th width="221.99993896484375">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>m</strong> — Load output (vector of three elements)</td><td>Vector that contains these three signals: - Positive-sequence voltage (pu) - Active power P (W) - Reactive power Q (vars)</td></tr></tbody></table>

### Conserving

<table><thead><tr><th width="313.20001220703125">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>A</strong> — Phase A terminal (SPS electrical)</td><td>SPS electrical conserving port associated with the terminal of phase A.</td></tr><tr><td><strong>B</strong> — Phase B terminal (SPS electrical)</td><td>SPS electrical conserving port associated with the terminal of phase B.</td></tr><tr><td><strong>C</strong> — Phase C terminal (SPS electrical)</td><td>SPS electrical conserving port associated with the terminal of phase C.</td></tr></tbody></table>

## Parameters

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

<table><thead><tr><th width="248.39996337890625">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Nominal L-L voltage and frequency [Vn(Vrms) fn(Hz)]</strong> — Nominal phase-to-phase voltage and frequency of load<br>[ 500e3 60 ] (default) | vector of two elements</td><td>Nominal phase-to-phase voltage, in volts RMS, and nominal frequency, in hertz, of the load.</td></tr><tr><td><strong>Active and reactive power at initial voltage [Po(W) Qo(var)]</strong> — Initial active and reactive power<br>[50e6 25e6] (default) | vector of two elements</td><td>Initial active power, Po, in watts, and initial reactive power, Qo, in vars, at the initial voltage, Vo. When you use the Machine Initialization tool of the powergui block to initialize the dynamic load and start simulation in steady state, these parameters are automatically updated according to the P and Q points specified for the load. When you use the Load Flow tool of the powergui block to initialize the dynamic load, these parameters represent the P and Q reference powers used by the load flow.</td></tr><tr><td><strong>Initial positive-sequence voltage Vo [Mag(pu) Phase (deg.)]</strong> — Magnitude and phase of initial positive-sequence voltage of load<br>[0.994 -11.8] (default) | vector of two elements</td><td>Magnitude and phase of the initial positive-sequence voltage of the load. When you use the Load Flow tool or the Machine Initialization tool of the powergui block to initialize the dynamic load and start simulation in steady state, this parameter is automatically updated using the values computed by the load flow.</td></tr><tr><td><strong>External control of PQ</strong> — Option to define active and reactive power of load<br>off (default) | on</td><td>Option to define the active power and reactive power of the load by using an external Simulink vector of two signals.</td></tr><tr><td><strong>[np nq]</strong> — Nature of the load<br>[1.3 2] (default) | vector of two elements</td><td>np and nq parameters that define the nature of the load. <strong>Dependencies:</strong> To enable this parameter, clear the <strong>External control of PQ</strong> parameter.</td></tr><tr><td><strong>Time constants [Tp1 Tp2 Tq1 Tq2] (s)</strong> — Time constants controlling dynamics of active and reactive power<br>[0 0 0 0] (default) | vector of four nonnegative elements</td><td>Time constants that control the dynamics of the active power and the reactive power. <strong>Dependencies:</strong> To enable this parameter, clear the <strong>External control of PQ</strong> parameter.</td></tr><tr><td><strong>Minimum voltage Vmin (pu)</strong> — Minimum voltage<br>0.7 (default) | nonnegative scalar</td><td>Minimum voltage at which the load dynamics commences. The load impedance is constant below this value. <strong>Dependencies:</strong> To enable this parameter, clear the <strong>External control of PQ</strong> parameter.</td></tr><tr><td><strong>Filtering time constant (s)</strong> — Time constant of current filter<br>1e-4 (default) | nonnegative scalar</td><td>Time constant, in seconds, of the current filter of the Three-Phase Dynamic Load block.</td></tr></tbody></table>

## Examples

The [Dynamic Load and Programmable Voltage Source](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/example-models/get-started-with-sps/dynamic-load-and-programmable-voltage-source.md) Preview (`power_dynamicload`) model uses a Three-Phase Dynamic Load block connected on a 500 kV, 60 Hz power network.


---

# 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/basics/passives/three-phase-dynamic-load.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.
