> 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/examples/renewable-energy/generic-wecc-ibr-grid-following-pv-plant.md).

# Generic WECC IBR: Grid-Following PV Plant

## Description

In the **Generic WECC IBR: Grid-Following PV Plant** example, located in **File > Open an Example File > Renewable Energy**, a **generic photovoltaic (PV) plant** injects active power into the grid and exchanges reactive power according to its control references. The system implements a **WECC generic grid-following PV plant** connected to the electrical network through a transformer and a transmission line, while the grid itself is represented by an ideal three-phase AC voltage source.

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

The model is intended for **dynamic performance studies**, including active power regulation, reactive power support, voltage response, and disturbance analysis under varying grid conditions.

## Requirements <a href="#requirements" id="requirements"></a>

This example model does not require any additional hardware or licenses.

## Detailed explanation

The generic PV plant follows the WECC standard structure and includes:

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-2c3db6e89591aec9d994928a7676fc0193c2cbff%2Fgeneric-WECC-IBR-model.png?alt=media" alt=""><figcaption><p>Generic PV plant structure</p></figcaption></figure>

* Renewable Energy Plant Controller – Type A ([REPC\_A](https://www.opal-rt.com/docs/hypersim/library-blocks-reference/control-smart-inverters/repc_a.md))
* Renewable Energy Electrical Controller – Type A ([REEC\_A](https://www.opal-rt.com/docs/hypersim/library-blocks-reference/control-smart-inverters/reec_a.md))
* Renewable Energy Generator/Converter – Type B ([REGC\_B](https://www.opal-rt.com/docs/hypersim/library-blocks-reference/control-smart-inverters/regc_b.md))

The generic PV plant operates as a **grid-following inverter**, synchronizing to the grid voltage through the **phase-locked loop (PLL)** implemented in the **REGC\_B** model. Operating references, including active power, reactive power, voltage, and frequency, are provided by a **Scenario\_Control** block, allowing the plant behavior to be evaluated under a variety of operating conditions.

A transformer connects the PV plant terminal bus (**BUS1**) to the transmission network (**BUS2**). The transformer steps up the plant terminal voltage to the grid voltage level and represents a typical utility-scale PV plant interconnection.

A three-phase **PI-section transmission line** connects **BUS2** and **BUS3**. The line model includes series resistance and reactance, as well as shunt capacitance, providing a realistic representation of the transmission system impedance.

At **BUS2**, a controllable breaker connects a shunt **R-L branch** to ground. Controlled by the **Scenario\_Control** block, this breaker enables the simulation of switching events and network disturbances.

At **BUS3**, the utility grid is represented by an ideal three-phase AC voltage source. This source establishes the system voltage and frequency and serves as the reference for power flow and synchronization.

Overall, the model provides a representative test system for studying the dynamic behavior of inverter-based resources, including active and reactive power control, voltage support, and responses to switching events and grid disturbances.

## Simulation and results

The example model is intended to introduce grid disturbances and reference active power changes to illustrate the dynamic behavior of the generic PV plant.

The flags of the generic PV plant are configured for active and reactive power control functionality.

<table><thead><tr><th>Flag</th><th>Value</th><th width="360.22216796875">Functionality</th></tr></thead><tbody><tr><td><strong>repc_FreqFlag</strong></td><td>1</td><td>Active power control</td></tr><tr><td><strong>repc_RefFlag</strong></td><td>0</td><td>Plant-level active power (Q) control</td></tr><tr><td><strong>reec_VFlag</strong></td><td>1</td><td>Terminal voltage regulation</td></tr><tr><td><strong>regc_RateFlag</strong></td><td>1</td><td>Power ramp limited by Rrpwr</td></tr></tbody></table>

One scenario with two events is prepared for this example model. The scenario events:

1. At 2 s, the breaker closes to connect the load to the network.
2. At 2.1 s, the breaker reopens to disconnect the load.
3. At 5 s, the reference active power PplantRef reduces from 600 MW to 550 MW.

The simulation default time step is 50 µs. The model is set **‘Perform load flow and set initial conditions’ at simulation start in simulation start'.** The generic PV plant terminal bus is PV type; the PV plant block is initialized based on the load flow solution.

1. Press ‘Start’ to run the simulation. The load flow will perform and set initial conditions automatically.
2. Open ScopeView.
3. Open the example ScopeView template (Generic\_WECC\_IBR\_GFL\_PVPlant.svt) from the example folder.
4. Run the template, and then the simulation results can be visualized.

### Simulation Results Analysis <a href="#simulation-results-analysis" id="simulation-results-analysis"></a>

The scenario record is 7s, and contains two events: Event 1-Load Connection Disturbance (2-2.1s), and Event 2-Active Power Reference Change (5s).

The following figures show the simulation results of this model.

#### **Event 1 – Load Connection Disturbance (2–2.1 s).**

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b8fc74ef168f16a242118963f858c0271623cc68%2Fgeneric-WECC-IBR-results-1.png?alt=media" alt=""><figcaption></figcaption></figure>

In the **Generic PV Plant Active Power and Reactive Power** figure, before 2 s the system is initialized from the load flow solution and operates in steady state. The active power closely tracks the reference value of 600 MW, and the reactive power follows the load flow operating point.

At 2 s, the breaker closes and connects the load to the network. The sudden load connection increases current demand and causes a voltage dip at the PV terminal due to the additional current flowing through the transformer and line impedance. As a result, the active power deviates from its steady-state value and exhibits transient oscillations. Because the generic PV plant operates in grid-following mode, the PLL and current controller respond to the disturbed voltage. With voltage regulation enabled (VFlag = 1), the controller attempts to inject reactive current to support the terminal voltage, producing a large transient change in reactive power.

At 2.1 s, the breaker reopens and disconnects the load. Once the disturbance is removed, the power oscillations gradually decay, and the active power smoothly returns to its reference value of 600 MW. The reactive power also settles back to its steady-state level, indicating stable control behavior and adequate damping in the system.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-71a345ca03a1ed992e3f09dc214c40c1e899841d%2Fgeneric-WECC-IBR-results-2.png?alt=media" alt=""><figcaption></figcaption></figure>

In the **Generic PV Plant Terminal Current and Voltage** figure, the load connection causes a sharp increase in terminal current and a noticeable voltage dip. Although voltage regulation is enabled, the inverter current reaches its maximum allowable magnitude (**reec\_Imax = 1.1 pu**). Because the current magnitude is saturated, the controller cannot inject additional reactive current to fully restore the voltage while the load remains connected, and the terminal voltage remains depressed during the 2–2.1 s interval.

At 2.1 s, the breaker reopens and disconnects the load. Once the disturbance is removed, the oscillations decay and the active power returns smoothly to 600 MW, while the reactive power settles back to its steady-state level. The terminal voltage recovers to the reference value (Vref = 1.0139 pu) with a well-damped response.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-9902848539502ab0a0054c87923affbbfaad7f36%2Fgeneric-WECC-IBR-results-3.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Current Limit Logic** figure confirms that when the load is connected, the combined active and reactive current demand reaches the configured limit (**reec\_Imax = 1.1 pu**), activating the current limiter. After the disturbance is cleared, the current magnitude drops below the limit and the limiter disengages, allowing the system to return to normal operation.

#### **Event 2 – Active Power Reference Change (5 s).**

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-da442ca08b9e2fa92af970e206b4920dca47c4e9%2Fgeneric-WECC-IBR-results-4.png?alt=media" alt=""><figcaption></figcaption></figure>

In the **Generic PV Plant Active Power and Reactive Power** figure, the system operates in steady state before 5 s, with the active power tracking the reference value of 600 MW and the reactive power remaining near its steady-state operating point.

At 5 s, the active power reference is reduced from 600 MW to 550 MW. The generic PV plant responds by decreasing the active current, causing the active power to track the new reference value smoothly. A small undershoot is observed before the active power settles at 550 MW, indicating a well-damped response of the active power control loop. During this event, the reactive power remains nearly unchanged, showing that the active and reactive control loops are largely decoupled.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-28550d59efe28434522ae054f774126727be8eeb%2Fgeneric-WECC-IBR-results-5.png?alt=media" alt=""><figcaption></figcaption></figure>

In the **Generic PV Plant Terminal Current and Voltage** figure, the terminal currents remain balanced and sinusoidal throughout the event. As the active power decreases, the current magnitude is slightly reduced, reflecting the lower active current required to deliver 550 MW. The terminal voltages remain stable and balanced, and the voltage magnitude continues to follow the reference value (Vref = 1.0139 pu).

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-50489583ff2dc7e1b52fe580d0b6031be8478cff%2Fgeneric-WECC-IBR-results-6.png?alt=media" alt=""><figcaption></figcaption></figure>

The **Current Limit Logic** figure shows that when the active power reference changes at 5 s, the active current command (Ipcmd) decreases accordingly while the reactive current command (Iqcmd) remains nearly constant. The total current magnitude remains well below the configured limit (**reec\_Imax = 1.1 pu**), so the current limiter is not activated. This demonstrates that the PV plant can smoothly track the new active power reference without affecting voltage regulation.

{% hint style="info" %}

## Acknowledgements <a href="#acknowledgements" id="acknowledgements"></a>

We acknowledge that Natural Resource Canada has participated in the implementation of all the blocks in the Smart Inverter Modeling Toolbox software.
{% endhint %}

## References

\[1] Western Electricity Coordinating Council (WECC), *WECC Solar PV Dynamic Model Specification*, Renewable Energy Modeling Task Force (REMTF), Sep. 2012.


---

# 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/examples/renewable-energy/generic-wecc-ibr-grid-following-pv-plant.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.
