Skip to main content

​
Pipeline Stages

The energy-model worker executes a deterministic stage chain.

​
End-to-End Sequence

  1. Timestamp alignment and weather preprocessing
  2. Sun position calculation (Ineichen-style formulation)
  3. Surface orientation (fixed or tracker)
  4. Irradiance decomposition (GHI -> DNI + DHI, Erbs/Erbs-Driesse)
  5. Plane-of-array transposition (Perez-family diffuse treatment)
  6. Far shading adjustment
  7. Near shading adjustment (unlimited or Octavia scene-driven)
  8. AOI correction
  9. Soiling losses and effective irradiance
  10. Cell temperature modeling
  11. Optional bifacial augmentation
  12. Optional spectral correction
  13. DC operating point and module/string scaling
  14. AC conversion, clipping, and subsystem losses
  15. Aggregation into summary metrics and time-series outputs

​
Multi-MPPT Handling

When dcInputs are provided, each input path is computed independently at the DC stage, then merged deterministically for inverter-level behavior.

​
Async Execution Context

The pipeline runs in the energy-model worker, triggered via task queueing. API returns a queued 200 payload immediately while computation proceeds in background.