Skip to content

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 Ns modules in series per string and Np strings in parallel, so the array voltage is Ns times the module voltage and the array current Np times the module current. Each module is the single-diode equation:

I=Iph−I0(e(V+IRs)/a−1)−V+IRsRsh,a=nNcellkTq

The parameters come from the datasheet values at 1000 W/m² and 25 °C:

  • Iph, the photocurrent, is Isc scaled by the irradiance G/1000.
  • I0, the diode saturation current, is chosen so the curve passes through Voc at zero current.
  • The ideality factor n shapes the knee: larger values round it and lower the maximum-power voltage.
  • Rs and Rsh tilt the two ends of the curve.

Temperature moves Isc and Voc by their datasheet coefficients (α, β in % per °C) and changes the thermal voltage in a. Hot cells lose voltage, about 0.3 % per °C, and gain a little current.

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 ​

PortKindSignalNotes
pElectrical terminal—
nElectrical terminal—
GControl inputRealShown when Irradiance from is Input (G)
TControl inputRealShown when Temperature from is Input (T)

Parameters ​

Config ​

ParameterTypeDefaultUnitsDescriptionID
Modules per stringNumber20—Number of modules in series in each string.n_series
StringsNumber18—Number of parallel strings.n_parallel
Irradiance fromChoice: 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
GNumber1000W/m² (also kW/m²)Irradiance on the array. 1000 W/m² is the datasheet reference.irradiance
Temperature fromChoice: Parameter / Input (T)Parameter—`Parameter` = the fixed value below. `Input` = the `T` control input in °C (one step late).temperature_source
T cellNumber25°C (also K)Cell temperature. 25 °C is the datasheet reference.temperature
Measure currentChoice: Off / OnOff—Emit the array current out of the + terminal as an observable. The signal name and unit are on this row.measure_current
Positive directionChoice: +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 voltageChoice: Off / OnOff—Emit the array voltage V(+) - V(-) as an observable. The signal name and unit are on this row.measure_voltage
Monitor powerChoice: Off / OnOff—Emit the array output power V·I as an observable. The signal name and unit are on this row.monitor_power

Module ​

ParameterTypeDefaultUnitsDescriptionID
IscNumber9.1A (also mA)Module short-circuit current at 1000 W/m² and 25 °C (datasheet).i_sc
VocNumber37.6V (also kV)Module open-circuit voltage at 1000 W/m² and 25 °C (datasheet).v_oc
CellsNumber60—Number of cells in series in one module.n_cells
nNumber1.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
RsNumber0.2Ω (also mΩ)Series resistance of one module. 0 = none.r_series
RshNumber300Ω (also kΩ)Shunt resistance of one module. 0 = none (infinite).r_shunt
α IscNumber0.05—Temperature coefficient of Isc (% per °C).alpha_isc
β VocNumber-0.3—Temperature coefficient of Voc (% per °C).beta_voc

Signal Names ​

ParameterTypeDefaultUnitsDescriptionID
Current nameTextI_pvA (also kA)Signal name for the array current out of the + terminal. Blank = skip.current_name
Voltage nameTextV_pvV (also kV)Signal name for the array voltage. Blank = skip.voltage_name
Power nameTextP_pvkW (also W, MW)Signal name for the array output power. Blank = skip.power_name

Observables ​

Default nameKindRecorded whenDescriptionID
set by Current nameSignalMeasure current is onArray 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 nameSignalMeasure voltage is onArray voltage V(+) - V(-), scaled to the chosen unit (V / kV).terminalVoltage
set by Power nameSignalMonitor power is onArray output power V·I, scaled to the chosen unit (W / kW / MW).p_out