Appearance
PV Array
Photovoltaic array: parallel strings of series modules, each module the single-diode equation with series and shunt resistance, built from the datasheet short-circuit current, open-circuit voltage, cell count and ideality factor. Irradiance and cell temperature are parameters or control inputs, with the usual Isc and Voc temperature coefficients. Each step the I-V curve is linearised at the previous terminal voltage and stamped as its tangent (a conductance plus a current source), so the array is stable on any DC circuit, including a bare capacitor. Bypass diodes and partial shading are not modelled. Monitors the current (A / kA), voltage (V / kV) and output power (W / kW / MW). Use it as the DC source of a solar plant with a boost converter and MPPT. Takes no part in the load flow.
Category: Single-Phase / Sources
How it works
The array is
The parameters come from the datasheet values at 1000 W/m² and 25 °C:
, the photocurrent, is scaled by the irradiance . , the diode saturation current, is chosen so the curve passes through at zero current. - The ideality factor
shapes the knee: larger values round it and lower the maximum-power voltage. and tilt the two ends of the curve.
Temperature moves
Simulation
The I-V curve is strongly nonlinear near open circuit: its slope reaches several siemens for a 100 kW array. Each time step, the array solves the single-diode equation at the previous terminal voltage and stamps the tangent of the curve there, a conductance in parallel with a current source. The network solve stays linear, and because the stamped slope is always the true one, the array is stable on any DC circuit, including a bare capacitor or an open circuit.
Irradiance and temperature can be fixed parameters or wired control inputs (G in W/m², T in °C), for cloud transients or a measured irradiance profile.
Notes
- Use a capacitor across the array terminals, as on a real converter input, whenever a converter regulates the array voltage.
- Bypass diodes, partial shading and mismatch between modules are not modelled: every module sees the same irradiance and temperature.
- The array takes no part in the load flow. On the AC side, schedule the inverter it feeds.
Ports
| Port | Kind | Signal | Notes |
|---|---|---|---|
p | Electrical terminal | — | |
n | Electrical terminal | — | |
G | Control input | Real | Shown when Irradiance from is Input (G) |
T | Control input | Real | Shown when Temperature from is Input (T) |
Parameters
Config
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Modules per string | Number | 20 | — | Number of modules in series in each string. | n_series |
| Strings | Number | 18 | — | Number of parallel strings. | n_parallel |
| Irradiance from | Choice: Parameter / Input (G) | Parameter | — | `Parameter` = the fixed value below. `Input` = the `G` control input in W/m² (one step late, the standard control-to-network delay). | irradiance_source |
| G | Number | 1000 | W/m² (also kW/m²) | Irradiance on the array. 1000 W/m² is the datasheet reference. | irradiance |
| Temperature from | Choice: Parameter / Input (T) | Parameter | — | `Parameter` = the fixed value below. `Input` = the `T` control input in °C (one step late). | temperature_source |
| T cell | Number | 25 | °C (also K) | Cell temperature. 25 °C is the datasheet reference. | temperature |
| Measure current | Choice: Off / On | Off | — | Emit the array current out of the + terminal as an observable. The signal name and unit are on this row. | measure_current |
| Positive direction | Choice: +ve in / +ve out | +ve out | — | Sign convention for this current. '+ve out' (default) is positive when current flows out of the p terminal. '+ve in' flips the sign. | current_dir |
| Measure voltage | Choice: Off / On | Off | — | Emit the array voltage V(+) - V(-) as an observable. The signal name and unit are on this row. | measure_voltage |
| Monitor power | Choice: Off / On | Off | — | Emit the array output power V·I as an observable. The signal name and unit are on this row. | monitor_power |
Module
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Isc | Number | 9.1 | A (also mA) | Module short-circuit current at 1000 W/m² and 25 °C (datasheet). | i_sc |
| Voc | Number | 37.6 | V (also kV) | Module open-circuit voltage at 1000 W/m² and 25 °C (datasheet). | v_oc |
| Cells | Number | 60 | — | Number of cells in series in one module. | n_cells |
| n | Number | 1.3 | — | Diode ideality factor. Together with Rs it shapes the knee of the I-V curve: larger values round it and lower the maximum-power voltage. | ideality |
| Rs | Number | 0.2 | Ω (also mΩ) | Series resistance of one module. 0 = none. | r_series |
| Rsh | Number | 300 | Ω (also kΩ) | Shunt resistance of one module. 0 = none (infinite). | r_shunt |
| α Isc | Number | 0.05 | — | Temperature coefficient of Isc (% per °C). | alpha_isc |
| β Voc | Number | -0.3 | — | Temperature coefficient of Voc (% per °C). | beta_voc |
Signal Names
| Parameter | Type | Default | Units | Description | ID |
|---|---|---|---|---|---|
| Current name | Text | I_pv | A (also kA) | Signal name for the array current out of the + terminal. Blank = skip. | current_name |
| Voltage name | Text | V_pv | V (also kV) | Signal name for the array voltage. Blank = skip. | voltage_name |
| Power name | Text | P_pv | kW (also W, MW) | Signal name for the array output power. Blank = skip. | power_name |
Observables
| Default name | Kind | Recorded when | Description | ID |
|---|---|---|---|---|
| set by Current name | Signal | Measure current is on | Array current out of the + terminal, scaled to the chosen unit (A / kA). Positive out of the p terminal for '+ve out' (default); the other direction flips the sign. | branchCurrent |
| set by Voltage name | Signal | Measure voltage is on | Array voltage V(+) - V(-), scaled to the chosen unit (V / kV). | terminalVoltage |
| set by Power name | Signal | Monitor power is on | Array output power V·I, scaled to the chosen unit (W / kW / MW). | p_out |