> 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/library-blocks-reference/network-renewable-energy/photovoltaic-array-pv.md).

# Photovoltaic Array (PV)

## Description

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-55a158b8ce23f890363d8c81b99d1a20fcc72a21%2Fimage%20(675).png?alt=media" alt="" width="141"><figcaption></figcaption></figure>

The **Photovoltaic Array (PV)** block models a photovoltaic (PV) module as a current source in parallel with a diode, plus a series resistance (Rs) and a shunt resistance (Rsh). The generated current varies with solar irradiance (S) and cell temperature (T).

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-b0258dbac5cb62a591b786722baa7350c4247ffc%2Fimage%20(676).png?alt=media" alt="" width="375"><figcaption><p>PV Panel Equivalent Circuit Diagram</p></figcaption></figure>

The terminology followed in the PV modeling is given below:

* **Cell**: single unit of the photovoltaic semiconductor that converts the solar irradiance into electricity.
* **Module**: group of cells connected in series and parallel to achieve a desired voltage and current.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-ebc83b4765ed521a7b944a642a549124aff43fb1%2Fimage%20(677).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

The characteristics of the diode for a single module is defined by the equation:

$$
I\_d = I\_0 (e^{\frac{V\_d}{V\_T}}-1)
$$

where

$$
V\_T=\frac{k \times T}{q} \times  nI \times Ncell
$$

I<sub>d</sub> is the current of the diode (A), V<sub>d</sub> is the voltage of the diode (V), I<sub>0</sub> is the saturation current of the diode (A), nI is the ideality factor which is generally close to 1.0, k is the Boltzmann constant(1.3806 e-23 J / K) q is the electron charge (1.6022 e-19 C) T is the temperature of the cell (K) and Ncell is the number of cells connected in series in a module PV.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-afaf49cef794e08072918c04503f4287aa1ab769%2Fimage%20(679).png?alt=media" alt="" width="375"><figcaption><p>D<strong>ependence on the Solar Irradiance and the Temperature</strong></p></figcaption></figure>

In the developed PV model, the diode is replaced with a nonlinear resistor that accurately represents PV behavior across different input temperatures. The temperature can be adjusted during the simulation, both offline and in real time. Similarly, the shunt resistor is replaced with a variable resistor that depends on the irradiance S.

<figure><img src="https://3623212549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLxgTpoh7kyPmQ5vuyqD7%2Fuploads%2Fgit-blob-5a71148b1489e88f856c1c71a94e438c426aa073%2Fimage%20(678).png?alt=media" alt="" width="563"><figcaption><p>Internal circuit of the PV model.</p></figcaption></figure>

{% hint style="info" %}
The model PV model contains many types of modules PV predefined from the database Photovoltaic (PV) modules to the Energy Commission's Solar Equipment Lists of the California Energy Commission (CEC) (November 2018). More than 21,000 modules from leading manufacturers are listed in this database includes the manufacturer's specifications measured for standard test conditions (STC) (Irradiance of 1000 W/m2 and 25 ° C).
{% endhint %}

{% hint style="danger" %}
When **creating a custom PV module**, the 5 parameters must be updated using an optimization function external to HYPERSIM.
{% endhint %}

<mark style="background-color:yellow;">At the time of this writing (</mark><mark style="background-color:yellow;">**DEC2019)**</mark><mark style="background-color:yellow;">, this model does not participate in the load flow solution.</mark>

## Mask parameters

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

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

| Parameter                                   | Description                                                                                                      |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Description**                             | Selected PV module name from the Database tab or write your own                                                  |
| **Number of modules connected in parallel** | Number of modules connected in parallel. Variable: Npar                                                          |
| **Number of modules connected in series**   | Number of modules connected in series. Variable: Nser                                                            |
| **Maximum power Pmax**                      | Power at the maximum power point Pmax = Vmp × Imp (W)                                                            |
| **Number of cells per unit**                | Number of cells per module. Variable: Ncell                                                                      |
| **Open circuit voltage**                    | Voltage when the array terminals are open (V). Variable: Voc                                                     |
| **Short circuit current**                   | Current when the array terminals are shorted (A). Variable: Isc                                                  |
| **Voltage at maximum power point**          | Voltage at the maximum power point (V). Variable: Vmp                                                            |
| **Current at maximum power point**          | Current at the maximum power point (A). Variable: Imp                                                            |
| **Temperature coefficient of Voc**          | Change in Voc as a function of temperature (% / °C). Variable: Beta\_Voc\_pc                                     |
| **Temperature coefficient of Isc**          | Change in Isc as a function of temperature (% / °C). Variable: Alpha\_Isc\_pc                                    |
| **Light-generated current**                 | Current (under STC) from the controllable current source modeling light-generated current (A). Variable: IL\_ref |
| **Diode saturation current**                | Diode saturation current under STC (A). Variable: I0\_ref                                                        |
| **Diode ideality factor**                   | PV module ideality factor. Variable: nI\_ref                                                                     |
| **Shunt resistance**                        | Shunt resistance under STC (Ohm). Variable: Rsh\_ref                                                             |
| **Series resistance**                       | Series resistance under STC (Ohm). Variable: Rs\_ref                                                             |
| {% endtab %}                                |                                                                                                                  |

{% tab title="Database" %}
This tab lets you select a PV module from the CEC database or define your own.\
The user can enter the module name or just a letter and then click on Inquiry and all the modules that contain that letter or name appear in the table. Once the selected module, the user must click **Load parameters** to load the model with the respective parameter values.

{% hint style="info" %}
When the user creates their own PV module, they must also update the 5 parameters from an optimization function external to HYPERSIM.
{% endhint %}

The user can also right click on the desired module and then choose the option “Load parameters in component” for the model parameters to be updated.
{% endtab %}
{% endtabs %}

## Conserving ports

<table><thead><tr><th width="199.5999755859375">Port</th><th>Description</th></tr></thead><tbody><tr><td><strong>Plus</strong></td><td>Network connector on the DC side; The + indicates this is the positive terminal (supports only 1-phase connections).</td></tr><tr><td><strong>Minus</strong></td><td>Network connector on the DC side; The - indicates this is the negative terminal (supports only 1-phase connections).</td></tr></tbody></table>

## Inputs

<table><thead><tr><th width="200.39996337890625">Input</th><th>Description</th></tr></thead><tbody><tr><td><strong>T</strong></td><td>PV cell temperature (°C)</td></tr><tr><td><strong>S</strong></td><td>Solar irradiance (W/m<sup>2</sup>)</td></tr></tbody></table>

## Outputs

<table><thead><tr><th width="198.79998779296875">Output</th><th>Description</th></tr></thead><tbody><tr><td><strong>V</strong></td><td>DC output voltage (V)</td></tr><tr><td><strong>I</strong></td><td>DC output current (A)</td></tr></tbody></table>

## References <a href="#photovoltaicarray-pv-references" id="photovoltaicarray-pv-references"></a>

L. G. Monteiro Oliveira *et al*., "Computational implementation of photovoltaic modules mathematical models for software application to estimate PV systems energy production," *2015 International Conference on Solar Energy and Building (ICSoEB)*, Sousse, 2015, pp. 1-6

W. De Soto, S. A. Klein and W. Beckman. « Improvement and validation of a model for photovoltaic array performance ». *Solar energy*, vol. 80, no. 1, pp. 78-88, 2007

OPAL-RT Smart Power System - [PV Array block](https://www.opal-rt.com/docs/smart-power-simulation-software-sps/blocks-functions-tools/renewables/pv-array.md)

*Photovoltaic (PV) Modules to the Energy Commission’s Solar Equipment Lists*, California Energy Commission, Nov. 2018. \[Online].


---

# 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/library-blocks-reference/network-renewable-energy/photovoltaic-array-pv.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.
