This platform implements the PVUSA (Photovoltaics for Utility Scale Applications) empirical regression model to predict photovoltaic system energy production based on weather conditions. It incorporates a comprehensive Transitory Deterioration Rate (TDR) model that accounts for three degradation mechanisms:
1. Thermal Degradation (Arrhenius): Models accelerated aging due to elevated cell temperatures using activation energy principles (Ea ≈ 0.65 eV for EVA encapsulants).
2. Humidity Degradation (Hallberg-Peck): Captures moisture-induced corrosion and delamination through combined temperature-humidity acceleration factors.
3. Soiling Losses (HSU Model): Simulates particulate accumulation (PM10/PM2.5) and rain-based cleaning events using validated deposition velocities.
The workflow uses train/test temporal splitting to calibrate model coefficients on historical data (default: 2 years) and validate predictions on future unseen periods, preventing data leakage and ensuring realistic performance assessment.
Reads hierarchical JSON structure containing building metadata, array specifications (tilt, azimuth, module count), and temporal boundaries for the simulation period.
Retrieves hourly GTI, temperature, wind speed, humidity, and precipitation from Open-Meteo API. Applies wind correction to roof height and calculates cell temperature using Skoplaki model.
Performs Huber regression on filtered training samples (GTI > 50 W/m², midday hours) to extract c₁-c₄ coefficients. Uses IQR and Hampel outlier removal for robustness.
Applies empirical regression model to full dataset, then multiplies by combined TDR factor: TDR(t) = [1-D_thermal][1-w_h·D_humidity]·SR(t), where SR is the soiling ratio from HSU model.
Computes R², RMSE, MAE, MAPE, and cumulative error separately for training period, test period, and combined dataset. Generates scatter plots and residual diagnostics.
Fetches 15-day weather forecast from Open-Meteo Forecast API and applies calibrated PVUSA model with TDR to predict future energy production. Uses current system degradation state as baseline.