Performance Ratio
The Performance Ratio page (at /kpi/performanceRatio) computes the PR of a plant over a user-defined date range, comparing the actual production with the theoretical one derived from irradiation and module/ambient temperatures.
Three calculation variants are available:
- PR DC — DC-side efficiency.
- PR AC — AC-side efficiency.
- Both — side-by-side comparison of DC and AC.
Sensor sources (production, irradiation, module temperature, ambient temperature) can be customised through the Sources drawer: the calculation is redone with the chosen signals and a dedicated badge highlights that the current result uses custom sources.
Toolbar
On the left:
- Date range — date picker with time; the range is propagated to the calculation and to the Trend deep-link.
- Plant — single-selection plants tree.
- PR type — select with DC, AC, both.
- Custom badge — appears when at least one source has been replaced via the drawer.
On the right:
- Export CSV ( ) — exports the computed daily data of the period.
- Sources — opens a drawer where you can choose custom signals for production, irradiation, module temperature and ambient temperature. You can also save a snapshot of the sources to re-apply later.
- Calculate — runs the calculation. When the displayed data no longer matches the current configuration, an amber dot appears on the button (stale).
KPI strip
After running the calculation, an aggregated KPI strip appears at the top of the results area.
The KPIs change depending on the PR type chosen (DC, AC, both). Typically they include:
| KPI | Meaning |
|---|---|
| Average PR | Average Performance Ratio over the period. |
| Expected production | Theoretical energy expected given irradiation and module conditions. |
| Measured production | Energy actually produced by the plant. |
| Efficiency | Ratio between measured and expected production. |
When data is stale (the configuration changed but Calculate has not been re-run), the strip is rendered with reduced opacity as a reminder to re-run Calculate.
Daily chart
The chart plots the daily PR value over the selected period.
Hover the chart to read the value of each day. When the PR type is "both", DC and AC are drawn as two overlaid series, distinguishable in the legend.
The Open in Trend button at the top right of the chart jumps to the Trend page with the underlying signals pre-selected and the current date range: useful to inspect the raw measurements (irradiation, temperature, production) behind every point.
Custom sources
The Sources drawer lets you replace one or more of the four default sources used by the calculation. For each family (Production, Irradiation, Module Temperature, Ambient Temperature) you can choose:
- Default — the signal automatically resolved by the system.
- Custom — a specific tag, picked manually.
When the drawer is closed with Apply, the calculation is re-run with the new configuration and the Custom badge appears in the toolbar. A custom source is valid only for the current working session unless it is saved as a snapshot.
CSV export
The CSV button downloads a file with the daily PR detail and the period aggregates. The file contains:
- a header comment with
# Plant: <name>and# Range: <from> → <to>; - a header row with
Date | PR DC | PR AC | Expected production | Measured production | Efficiency(the columns depend on the chosen PR type); - one row per day in the period;
- a final summary block with the same KPIs as the strip.
Numbers are formatted in the user's locale.