> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plantpredict.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Variable Input-Output Table

export const Parallax = () => <Tooltip tip="Apparent shift in sun's position due to observer being on earth's surface rather than at its center.">
    parallax
  </Tooltip>;

export const ClearnessIndexCap = () => <Tooltip tip="Ratio of measured GHI to extraterrestrial irradiance; quantifies atmospheric transmittance.">
    Clearness Index
  </Tooltip>;

export const AirMassCap = () => <Tooltip tip="Ratio of atmospheric path length to path length at zenith; equals 1 when sun is overhead.">
    Air Mass
  </Tooltip>;

export const AzimuthCap = () => <Tooltip tip="Horizontal angle measured clockwise from north; applies to sun direction or surface orientation.">
    Azimuth
  </Tooltip>;

export const ZenithAngleCap = () => <Tooltip tip="Angle between the local vertical and the sun (0° = overhead, 90° = horizon).">
    Zenith Angle
  </Tooltip>;

This table provides a comprehensive mapping of variables and parameters in the PlantPredict engine: external inputs, model parameters, key interface variables between models, and final outputs.

<div className="variable-map">
  ## External Inputs

  ### **Weather Data**

  | Variable | Symbol | Units | Destination(s) |
  | - | - | - | - |
  | UTC Date-Time | — | datetime | • Solar Position<br />• Extraterrestrial Irradiance<br />• Sunrise/Sunset Model |
  | Global Horizontal Irradiance | $GHI$ | W/m² | • Irradiance Quality Check<br />• Decomposition<br />• Transposition<br />• Ground-Reflected Shading |
  | Direct Normal Irradiance | $DNI$ | W/m² | • Irradiance Quality Check<br />• Transposition<br />• Ground-Reflected Shading |
  | Diffuse Horizontal Irradiance | $DHI$ | W/m² | • Irradiance Quality Check<br />• Transposition<br />• Ground-Reflected Shading |
  | Ambient Air Temperature | $T_a$ | °C | • Solar Position (refraction)<br />• Module Temperature<br />• Inverter Derating<br />• Decomposition (Reindl)<br />• Spectral Models |
  | Wind Speed | $v_w$ | m/s | Module Temperature |
  | Atmospheric Pressure | $P$ | hPa | • Solar Position (refraction)<br />• Air Mass<br />• Decomposition (DIRINT)<br />• Bird Clear Sky |
  | Relative Humidity | $RH$ | % | • Decomposition (Reindl)<br />• Spectral Models |
  | Wind Gust Speed | $v_{gust}$ | m/s | Wind Stow |
  | Dewpoint Temperature | $T_d$ | °C | Spectral Models |
  | Plane-of-Array Irradiance | $G_{POA}$ | W/m² | POAI Decomposition (when Frontside POAI enabled) |

  ### **Site Configuration**

  | Variable | Symbol | Units | Destination(s) |
  | - | - | - | - |
  | Latitude | $\varphi$ | degrees | Solar Position |
  | Longitude | $\lambda$ | degrees | Solar Position |
  | Altitude | $h$ | m | • Solar Position (<Parallax />)<br />• Pressure calculation<br />• Inverter Derating |
  | Albedo | $\rho$ | — | • Transposition<br />• Bifacial Model<br />• Bird Clear Sky |
  | Standard UTC Offset | $\text{UTC}_{\text{off}}$ | hours | Sunrise/Sunset Model |
  | Horizon Profile | $(\gamma_i, e_i)$ | degrees | Horizon Shading |

  ### **Other Time Series Inputs (Optional)**

  | Input | Units | Used In | |
  | - | - | - | - |
  | Monthly Albedo Factors | — | Transposition | |
  | Monthly Soiling Factors | % | Soiling Model | |
  | Module Temperature Time Series | $T_{m,measured}$ | °C | Override calculated temperature |
  | Tracking Angle Time Series | degrees | User-defined tracking | |
  | Vmpp Time-Series Adjustment | $\Delta V_{MPP}$ | % | Operating Region (V7+) |
  | Impp Time-Series Adjustment | $\Delta I_{MPP}$ | % | Operating Region (V7+) |
  | Inverter Derate Time Series | — | Power derating schedule | |
  | Inverter Set Point Time Series | W | Power limiting schedule | |
  | LGIA Limit Time Series | MW | POI power clipping | |

  ***

  ## Model Parameters

  ### **Module Parameters (Single Diode Model)**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Reference Short-Circuit Current | $I_{sc,ref}$ | A | Parameter Translation<br />→ Single Diode Model |
  | Reference Power | $P_{mp,ref}$ | W | Parameter Translation / DC Wiring Resistance |
  | Number of Cells in Series | $N_c$ | — | • Parameter Translation<br />• Single Diode Model |
  | Temperature Coefficient of Isc | $\alpha_{I_{sc}}$ | %/°C | Parameter Translation<br />→ Single Diode Model |
  | Diode Ideality Factor | $\gamma_{ref}$ | — | Parameter Translation |
  | Temp. Coeff. of Ideality Factor | $\alpha_{\gamma}$ | 1/°C | Parameter Translation |
  | Ideality Factor Polynomial Coefficients | $a_\gamma, b_\gamma, c_\gamma, d_\gamma$ | various | Parameter Translation |
  | Reference Series Resistance | $R_{s,ref}$ | Ω | Parameter Translation<br />→ Single Diode Model |
  | Reference Shunt Resistance | $R_{sh,ref}$ | Ω | Parameter Translation<br />→ Single Diode Model |
  | Reference Saturation Current | $I_{0,ref}$ | A | Parameter Translation<br />→ Single Diode Model |
  | Dark Shunt Resistance | $R_{sh,0}$ | Ω | Parameter Translation (irradiance)<br />→ Single Diode Model |
  | Shunt Resistance Exponent | $R_{sh,exp}$ | — | Parameter Translation (irradiance)<br />→ Single Diode Model |
  | Bandgap Energy | $E_g$ | eV | Parameter Translation (temperature)<br />→ Single Diode Model |
  | Recombination Parameter | $d_i^2/\mu\tau$ | V | Single Diode Model (7-parameter) |
  | Built-in Voltage | $V_{bi}$ | V | Single Diode Model (7-parameter) |
  | Reference Irradiance | $G_{ref}$ | W/m² | • Parameter Translation<br />• Temperature Models<br />• DC Wiring Resistance |
  | Reference Temperature | $T_{ref}$ | °C | • Parameter Translation<br />• DC Wiring Resistance |

  ### **Module Temperature Parameters**

  | Parameter | Symbol | Units | Model |
  | - | - | - | - |
  | Conductive Heat Transfer Coefficient | $u_c$ | W/m²·K | Heat Balance |
  | Convective Heat Transfer Coefficient | $u_v$ | W/m²·K per m/s | Heat Balance |
  | Cell-to-Module Temperature Difference | $\Delta T_{c-m}$ | °C | All temperature models |
  | Absorption Coefficient | $\alpha_T$ | — | Heat Balance |
  | Module STC Efficiency | $\eta_{STC}$ | — | Heat Balance / NOCT-SAM |
  | Conductive Coefficient | $a$ | — | Sandia |
  | Convective Coefficient | $b$ | s/m | Sandia |
  | Transmittance-Absorptance | $\tau\alpha$ | — | NOCT-SAM |
  | NOCT | $NOCT$ | °C | NOCT-SAM |

  ### **Inverter Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Minimum MPP Voltage | $V_{MPP,min}$ | V | Operating Region |
  | Maximum MPP Voltage | $V_{MPP,max}$ | V | Operating Region |
  | Maximum Absolute Voltage | $V_{max}$ | V | Operating Region |
  | Minimum DC Power | $P_{min}$ | W | Operating Region |
  | AC Rated Power | $P_{AC,rated}$ | kVA | Power Limiting |
  | Efficiency Curves | $\eta_{V_j}(P_{AC,i})$ | kW, % | Efficiency Model |
  | Temperature-kVA Curves | $P_{AC,derate,h_k}(T_j)$ | °C, kVA | Temperature Derating |
  | AC Power Setpoint | $P_{AC,set}$ | kVA | Temperature Derating / Power Limiting |

  ### **DC Field & Loss Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Module Mismatch Coefficient | $f_{MM}$ | % | DC Power Reduction |
  | Light-Induced Degradation | $f_{LID}$ | % | DC Power Reduction |
  | Module Quality Factor | $f_{MQ}$ | % | DC Power Reduction |
  | DC Health Factor | $f_{DCH}$ | % | DC Power Reduction |
  | DC Wiring Loss Percentage | $L_{wire}$ | % | DC Wiring Resistance |
  | DC Wiring Resistance | $R_{DC,module}$ | Ω | Added to Series Resistance |
  | Degradation Rate (Linear) | $r_{deg}$ | %/year | Annual Degradation |
  | Nonlinear Degradation Rates | $[r_0, r_1, ...]$ | %/year | Nonlinear Degradation |
  | LeTID Annual Rates | $[l_0, l_1, ...]$ | %/year | LeTID Degradation |
  | Bifaciality Factor | $\phi$ | — | Rear-Side Weighting |
  | Structure Shading Factor | $f_{str}$ | % | Rear-Side Losses |
  | Backside Mismatch Factor | $f_{MM,rear}$ | % | Rear-Side Losses |
  | Module Transmission Factor | $\tau$ | — | Rear Irradiance (bifacial) |
  | SunSolve Transmission Gain | $f_T$ | — | Rear Irradiance (bifacial, SunSolve-calibrated mode) |
  | Field-Level Wiring Resistance | $R_{DC,field}$ | Ω | Loss Reporting |
  | Energization Date | $t_0$ | datetime | DC Degradation Model |

  ### **Transformer Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | MV Transformer No-Load Loss | $L_{NL,MV}$ | % | MV Transformer Model (quadratic) |
  | MV Transformer Full-Load Loss | $L_{FL,MV}$ | % | MV Transformer Model (quadratic) |
  | MV Transformer Rated Power | $P_{MV,rated}$ | kVA | Transformer Model (quadratic) |
  | HV Transformer No-Load Loss | $L_{NL,HV}$ | % | HV Transformer Model (quadratic) |
  | HV Transformer Full-Load Loss | $L_{FL,HV}$ | % | HV Transformer Model (quadratic) |
  | HV Transformer Rated Power | $P_{HV,rated}$ | MVA | HV Transformer Model (quadratic) |

  ### **AC System Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | AC Collection Loss | $f_{coll}$ | % | Array-Level Losses |
  | Transmission Line Resistance | $R_{line}$ | Ω/1000 ft | Transmission Loss |
  | Transmission Line Length | $\ell_t$ | km | Transmission Loss |
  | Transformer High-Side Voltage | $V_{HS}$ | kV | Transmission Loss |
  | Conductors per Phase | $N_{cond}$ | — | Transmission Loss |
  | Inverter Design Derate | $d$ | — | Power Factor / Transmission Loss |
  | Cooling Load | $L_{cool}$ | W | Auxiliary Load |
  | Tracker Motor Load | $L_{track}$ | W | Auxiliary Load |
  | DAS Load | $L_{DAS}$ | W | Auxiliary Load |
  | Availability Loss Factor | $f_{avail}$ | % | • Availability Loss<br />• Power Flow (ESS re-run) |
  | Grid Limit (LGIA) | $P_{POI}$ | MW | POI Power Clipping |

  ### **DC Field Geometry**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Fixed Tilt Angle | $\beta_{fixed}$ | degrees | Surface Orientation |
  | Fixed Azimuth Angle | $\gamma_{fixed}$ | degrees | Surface Orientation |
  | Tracker Axis Azimuth | $\gamma_{axis}$ | degrees | Tracking Algorithm |
  | Tracker Axis Tilt | $\beta_{axis}$ | degrees | Tracking Algorithm |
  | Minimum Rotation Limit | $\alpha_{min}$ | degrees | Tracking Algorithm |
  | Maximum Rotation Limit | $\alpha_{max}$ | degrees | Tracking Algorithm |
  | Nighttime Stow Angle | $\alpha_{stow,night}$ | degrees | Tracking Algorithm |
  | Wind Stow Angle | $\alpha_{stow,wind}$ | degrees | Wind Stow |
  | Ground Slope | $\beta_g$ | degrees | • Backtracking<br />• Shading Models |
  | Ground Slope Azimuth | $\gamma_g$ | degrees | • Backtracking<br />• Shading Models |
  | Ground Coverage Ratio | $GCR$ | — | • Backtracking<br />• Shading Models<br />• Bifacial Model |
  | Post Height | $h_{post}$ | m | Bifacial Model |
  | Row-to-Row Pitch | $p$ | m | • Shading Models<br />• Backtracking<br />• Bifacial Model<br />• GCR calculation |
  | Collector Width | $\ell_m$ | m | • Shading Models<br />• Backtracking<br />• Bifacial Model<br />• GCR calculation |
  | Row Length | $L$ | m | Row-to-Row Beam Shading |
  | Bay Pile Heights | $(h_{S,i}, h_{N,i})$ | m | Terrain-Aware Backtracking |
  | East Neighbor Pile Heights | $(h'_{E,S,i}, h'_{E,N,i})$ | m | Terrain-Aware Backtracking |
  | West Neighbor Pile Heights | $(h'_{W,S,i}, h'_{W,N,i})$ | m | Terrain-Aware Backtracking |
  | Bay Length | $L_b$ | m | Row-to-Row Beam Shading |
  | Bay Spacing | $s_b$ | m | Row-to-Row Beam Shading |
  | Bays Per Row | $N_b$ | — | Row-to-Row Beam Shading |
  | Number of Rows | $N_{rows}$ | — | Row-to-Row Beam Shading |
  | Cross-Axis Slope | $\beta_c$ | degrees | Sky Diffuse Shading |
  | DC Field Repeater Count | $n_{rep,i}$ | — | DC Field Aggregation |
  | Inverter Repeater Count | $n_{rep,inv}$ | — | Array-Level Losses |
  | Array Repeater Count | $n_{rep,array}$ | — | • Array-Level Losses<br />• Plant-Level Losses |
  | Block Repeater Count | $n_{rep,block}$ | — | Plant-Level Losses |
  | Strings per Inverter | $N_{p,i}$ | — | • Current scaling (parallel)<br />• DC wiring resistance |
  | Modules per String | $N_{s,i}$ | — | • String voltage (Vmp, Voc)<br />• DC wiring resistance |

  ### **Tracking Control Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Hesitation Factor | $f_h$ | — | Irradiance Optimization |
  | Rotation Speed | $\omega$ | degrees/s | Irradiance Optimization |
  | Wind Stow Threshold | $v_{threshold}$ | m/s | Wind Stow |
  | Time Interval | $\Delta t$ | seconds | Irradiance Optimization |
  | Time Interval | $\delta t$ | minutes | Battery Model |

  ### **Spectral Correction Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Sandia Polynomial Factors | $[a_0, ..., a_4]$ | — | Spectral Correction (Sandia) |
  | Two-Variable Coefficients | $[b_0, ..., b_5]$ | — | Spectral Correction (Two-Variable) |
  | Monthly Spectral Loss | $L_{spectr,month}$ | % | Spectral Correction (Monthly Override) |

  ### **Electrical Shading Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Fractional Shading Percent | $f$ | % | Electrical Shading (Fractional) |
  | Number of Module Rows | $M$ | — | Electrical Shading (Fractional, pre-V12) |
  | Number of Bay Fractions | $N$ | — | Electrical Shading (Step-Fractional, V12+) |

  ### **IAM Parameters**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | ASHRAE IAM Parameter | $b_0$ | — | IAM (ASHRAE) / Ground-Reflected Shading |
  | Sandia IAM Polynomial Factors | $[b_0, ..., b_5]$ | degree⁻ⁱ | IAM (Sandia) |
  | Refractive Index | $n$ | — | IAM (Physical) |
  | ARC Refractive Index | $n_{ARC}$ | — | IAM (Physical) |
  | Absorption Coefficient (glass) | $\alpha_{abs}$ | m⁻¹ | IAM (Physical) |
  | Glass Thickness | $L_{glass}$ | m | IAM (Physical) |
  | IAM Factor Pairs | $\{(\theta_i, f_i)\}$ | degrees, — | IAM (Tabular) |

  ### **ESS Parameters (Optional)**

  | Parameter | Symbol | Units | Used In |
  | - | - | - | - |
  | Nameplate Energy Capacity | $E_{nom}$ | MWh | State-of-Charge Calculation |
  | Usable Capacity Factor | $f_{usable}$ | — | State-of-Charge Calculation |
  | Initial Round-Trip DC Efficiency | $\eta_{RT,init}$ | % | Round-Trip Efficiency |
  | Capacity Cycle Degradation Rate | $d_{E,cycle}$ | %/cycle | Battery Degradation |
  | Capacity Calendar Degradation Rate | $d_{E,year}$ | %/year | Battery Degradation |
  | RTE Cycle Degradation Rate | $d_{\eta,cycle}$ | %/cycle | Battery Degradation |
  | RTE Calendar Degradation Rate | $d_{\eta,year}$ | %/year | Battery Degradation |
  | ESS Inverter Efficiency | $\eta_{inv}$ | % | DC/AC Conversion Efficiency (Charge/Discharge) |
  | ESS Inverter Rated AC Power | $P_{AC,rated,ESS}$ | MW | Charge & Discharge Limits |
  | ESS MV Transformer No-Load Loss | $L_{NL,ESS}$ | % | ESS Transformer Model (quadratic) |
  | ESS MV Transformer Full-Load Loss | $L_{FL,ESS}$ | % | ESS Transformer Model (quadratic) |
  | ESS MV Transformer Rating | $P_{MV,rated,ESS}$ | MVA | ESS Transformer Model (quadratic) |
  | Custom Inverter Capacity Fraction | $f_{cap}$ | — | Charge & Discharge Limits (Custom Dispatch) |
  | Dispatch Table | $D_{m,h}$ | boolean | Dispatch Algorithms |
  | Custom Dispatch Time Series | $C_t$ | — | Dispatch Algorithms |

  ***

  ## Stage 1: Irradiance Variables

  ### **Solar Position, Extraterrestrial, and Clear-Sky Irradiance**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Solar <ZenithAngleCap /> | $\theta_z$ | degrees | Solar Position Algorithm | • Air Mass<br />• Decomposition<br />• Transposition<br />• Shading<br />• Bird Clear Sky |
  | Solar <AzimuthCap /> Angle | $\gamma_s$ | degrees | Solar Position Algorithm | • Tracking<br />• Shading |
  | Sunrise Time | $t_{rise}$ | datetime | Sunrise/Sunset Model | • Operational hours<br />• Horizon Shading |
  | Sunset Time | $t_{set}$ | datetime | Sunrise/Sunset Model | • Operational hours<br />• Horizon Shading |
  | Extraterrestrial Direct Normal Irradiance | $DNI_{extra}$ | W/m² | Extraterrestrial Irradiance | • Transposition<br />• Decomposition<br />• Bird Clear Sky |
  | Clear-Sky Global Horizontal Irradiance | $GHI_{clear}$ | W/m² | Bird Clear Sky Model | Decomposition (DIRINT) |
  | Clear-Sky Direct Normal Irradiance | $DNI_{clear}$ | W/m² | Bird Clear Sky Model | Decomposition (DIRINT) |
  | Clear-Sky Diffuse Horizontal Irradiance | $DHI_{clear}$ | W/m² | Bird Clear Sky Model | Decomposition (DIRINT) |

  ### **Derived Irradiance Parameters**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Relative <AirMassCap /> | $AM$ | — | Air Mass Model | Transposition (Perez) |
  | Pressure-Corrected <AirMassCap /> | $AM'$ | — | Air Mass Model | • Decomposition (DIRINT)<br />• Spectral Models |
  | Precipitable Water | $W$ | cm | Weather file or calculated from RH/T | Spectral Models |
  | Spectral Correction Factor | $U_{spectr}$ | — | Spectral Model | POA Irradiance adjustment |

  ### **Tracker & Surface Orientation**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Tracker Rotation Angle | $\alpha$ | degrees | True Tracking | • Backtracking<br />• Irradiance Optimization |
  | Backtracking Angle | $\alpha_B$ | degrees | Standard Backtracking | Terrain-Aware Backtracking |
  | Terrain-Corrected Angle | $\alpha_{TABT,i}$ | degrees | Terrain-Aware Backtracking | Surface Orientation |
  | Optimized Tracker Angle | $\alpha_{opt}$ | degrees | Irradiance Optimization | Wind Stow / Surface Orientation |
  | Commanded Tracker Angle | $\alpha_{final}$ | degrees | Wind Stow | Surface Orientation |
  | Module Tilt Angle | $\beta_m$ | degrees | • Configuration<br />• Tracking | • Transposition (view factors)<br />• AOI Calculation |
  | Module Azimuth Angle | $\gamma_m$ | degrees | • Configuration<br />• Tracking | AOI Calculation |
  | Angle of Incidence | $\theta_{AOI}$ | degrees | Geometry Calculation | • Transposition (beam)<br />• IAM<br />• Row-to-row shading |

  ### **Plane-of-Array Irradiance Components**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Transposition Factor (Global) | $TF_{POA}$ | — | 3D Transposition | POA Irradiance adjustment |
  | Transposition Factor (Beam) | $TF_{beam}$ | — | 3D Transposition | POA Irradiance adjustment |
  | Transposition Factor (Sky Diffuse) | $TF_{sky}$ | — | 3D Transposition | POA Irradiance adjustment |
  | Transposition Factor (Ground) | $TF_{ground}$ | — | 3D Transposition | POA Irradiance adjustment |
  | Pre-Shading POA Irradiance (B/D/G) | — | W/m² | Transposition | Shading Models |
  | Shaded POA Irradiance (B/D/G) | — | W/m² | Shading Models | Soiling |
  | POA Irradiance After Soiling (B/D/G) | — | W/m² | Soiling Model | IAM |
  | POA Irradiance After IAM (B/D/G) | — | W/m² | IAM Model | Effective POA |
  | Front POA Irradiance | $G_{POA,front}$ | W/m² | Transposition (sum of B/D/G) | • NOCT-SAM Temperature Model<br />• Irradiance Optimization |
  | Effective Front POA Irradiance (B/D/G) | $G_{POA,front,eff}$ | W/m² | After All Adjustments | Effective POA Irradiance |
  | Back POA Irradiance (B/D/G) | — | W/m² | Bifacial Model | Effective POA Irradiance |
  | Effective POA Irradiance | $G_{POA,tot,eff}$ | W/m² | Front + Back × Bifaciality | Single Diode Model |

  ### **Loss/Adjustment Factors**

  | Variable | Symbol | Units | Origin | Applied To |
  | - | - | - | - | - |
  | Horizon Shading Factor | $U_{horizon}$ | — | Horizon Shading | Beam POA Irradiance |
  | Beam Shading Factor | $U_{shd,B}$ | — | Near Shading Models | Beam POA Irradiance |
  | Sky Diffuse Shading Factor | $U_{shd,D}$ | — | Diffuse Shading (view factors) | Sky Diffuse POA Irradiance |
  | Ground Shading Factor | $U_{shd,G}$ | — | Ground-Reflected Shading | Ground POA Irradiance |
  | Electrical Shading Factor | $U_{shd,B,elec}$ | — | Electrical Shading | Beam POA Irradiance |
  | Soiling Factor | $U_{soil}$ | — | Soiling Model | All POA Irradiance Components |
  | Beam IAM Factor | $U_{IAM,B}$ | — | IAM Model | Beam POA Irradiance |
  | Sky Diffuse IAM Factor | $U_{IAM,D}$ | — | IAM Model | Sky Diffuse POA Irradiance |
  | Ground Diffuse IAM Factor | $U_{IAM,G}$ | — | IAM Model | Ground POA Irradiance |

  ***

  ## Stage 2: DC Performance Variables

  ### **Module Temperature**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Cell Temperature | $T_c$ | °C | Temperature Model | Single Diode Model |
  | Module Surface Temperature | $T_m$ | °C | Temperature Model | Output |

  ### **DC System Losses & Parameter Translation**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Scaled Effective Irradiance | $G'_{POA,tot,eff}$ | W/m² | DC System Losses | Parameter Translation |
  | Series Resistance | $R_s$ | Ω | Parameter Translation | Single Diode Model |
  | Shunt Resistance | $R_{sh}$ | Ω | Parameter Translation | Single Diode Model |
  | Diode Ideality Factor | $\gamma$ | — | Parameter Translation | Single Diode Model |
  | Saturation Current | $I_0$ | A | Parameter Translation | Single Diode Model |
  | Photocurrent | $I_{ph}$ | A | Parameter Translation | Single Diode Model |

  ### **DC Power Outputs**

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | Open-Circuit Voltage | $V_{oc}$ | V | Single Diode Model | • Inverter Region Model<br />• Output |
  | Short-Circuit Current | $I_{sc}$ | A | Parameter Translation | Output |
  | MPP Voltage | $V_{mp}$ | V | Single Diode Model | Inverter Region Model |
  | MPP Current | $I_{mp}$ | A | Single Diode Model | Inverter Region Model |
  | MPP Power | $P_{mp}$ | W | $V_{mp} \times I_{mp}$ | Inverter Region Model |

  ***

  ## Stage 3: Inverter Variables

  | Variable | Symbol | Units | Origin | Destination(s) |
  | - | - | - | - | - |
  | DC Open-Circuit Voltage | $V_{DC,oc}$ | V | DC Field Aggregation | Inverter Region Model |
  | DC Voltage (after clipping) | $V_{DC}$ | V | Inverter Region Model | Inverter Efficiency Model |
  | DC Operating Power | $P_{DC}$ | W | Inverter Region Model | Inverter Efficiency Model |
  | Degraded DC Power | $P_{DC,deg}$ | W | DC Degradation Model | Inverter Region Model |
  | DC Degradation Loss | $L_{deg}$ | W | DC Degradation Model | Output |
  | DC LeTID Loss | $L_{LeTID}$ | W | DC Degradation Model | Output |
  | Temperature-Corrected Max Power | $P_{AC,derated}$ | W | Temperature Derating | Inverter Region Model |
  | Inverter Efficiency | $\eta$ | — | Inverter Efficiency Model | AC Power |
  | Inverter AC Power | $P_{AC,inv}$ | W | Inverter Efficiency Model | Inverter Aggregation |

  ***

  ## Stage 4: AC & Plant-Level Variables

  ### **Array Level**

  | Variable | Symbol | Units | Origin | Destination |
  | - | - | - | - | - |
  | Array AC Power | $P_{AC,array}$ | W | Inverter Aggregation | AC Degradation Model |
  | Degraded AC Power | $P_{AC,deg}$ | W | AC Degradation Model | Auxiliary Loads |
  | AC Degradation Loss | $L_{deg}$ | W | AC Degradation Model | Output |
  | LeTID Loss | $L_{LeTID}$ | W | LeTID Model | Output |
  | Auxiliary Loads | $P_{aux}$ | W | Cooling + Tracker + DAS | MV Transformer Model |
  | MV Transformer Loss | $L_{MV,trans}$ | W | MV Transformer Model | Output |
  | Block Power | $P_{block}$ | W | Array-Level Losses | Plant-Level Losses |

  ### **Energy Storage (Optional)**

  | Variable | Symbol | Units | Origin | Destination |
  | - | - | - | - | - |
  | PV MV Transformer Output | $P_{MV}$ | W | Array-Level Losses | • Charge & Discharge Limits<br />• Power Flow |
  | PV Power After Availability | $P_{avail}$ | W | Plant-Level Losses (PV-only) | • Charge & Discharge Limits<br />• Dispatch Algorithms |
  | HV Equipment Losses | $L_{HV}$ | W | Plant-Level Losses (PV-only) | Charge & Discharge Limits |
  | Charge Flag | $F_c$ | boolean | Dispatch Algorithms | Battery Model |
  | Discharge Flag | $F_d$ | boolean | Dispatch Algorithms | Battery Model |
  | Available Charge Power | $P_{charge}$ | W | Charge & Discharge Limits | Battery Model |
  | Available Discharge Power | $P_{discharge}$ | W | Charge & Discharge Limits | Battery Model |
  | State of Charge | $SOC$ | Wh | Battery Model | Battery Model (feedback) / Output |
  | Battery DC Power | $P_{DC,batt}$ | W | Battery Model | Power Flow |
  | DC RTE Loss | $L_{\eta}$ | W | Battery Model | Output |
  | Combined PV+ESS Power | $P_{combined}$ | W | Power Flow | HV Transformer Model (re-run) |

  ### **Plant Level**

  | Variable | Symbol | Units | Origin | Destination |
  | - | - | - | - | - |
  | Plant Power | $P_{plant}$ | W | Block Aggregation (or $P_{combined}$) | HV Equipment |
  | HV Transformer Loss | $L_{HV}$ | W | HV Transformer Model | Transmission Model |
  | Transmission Line Loss | $L_{line}$ | W | Transmission Model | Availability |
  | Power After HV Equipment | $P_{HV,out}$ | W | HV Equipment Chain | Availability |
  | Power After Availability | $P_{avail}$ | W | Availability Model | LGIA Clipping |
  | Grid Limit Clipping | $L_{LGIA}$ | W | LGIA Clipping | Output |
  | Grid Power | $P_{grid}$ | W | LGIA Clipping | Output |
</div>

***

**Notes:**

1. **B/D/G**: Beam, Diffuse, and Ground components are tracked and exported separately.
2. **V12+**: Some variables (e.g., Bay Fractions for electrical shading) are only available in Version 12 and later.
3. **Aggregation**: Power variables aggregate hierarchically: DC Field → Inverter → Array → Block → Plant.
4. **Timestep Loop**: All time-series variables are calculated for each timestep, then aggregated to hourly/daily/monthly/annual summaries.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.