Skip to main content
Skip table of contents

KPI editor for PR and system availability

Last modified:

About the KPI Editor

O&M contracts commonly require a system availability or performance ratio (PR) guarantee. Different companies may use different measured values to calculate this. It is therefore essential for O&Ms and investors to share a common understanding of how these KPIs are calculated. Once defined properly, KPIs enhance communication by providing clear and easily interpretable metrics.

The KPI Editor is a license-based VCOM module that allows you to:

  • Define the PR and system availability with standardized formulas

  • Select the measured values used for the calculations

  • Tailor the calculation to specific systems and data requirements

It is included for premium partners or can be purchased as an additional module. Contact Sales for more information.

Note

If no PR or system availability calculation is available, this could be due to missing data, an outage, or low irradiance. Check your data sources and alarms.

To help identify root causes, you can icon-download1.png download a CSV file to view the raw data used for the PR calculation (daily aggregation). The same root causes will affect system availability as well.

KPI Editor and ticket exclusion

Settings in the KPI Editor affect the ticket system and charts.

  • You can exclude intervals from the PR and system availability calculations by means of a ticket. This ensures that outages outside your contractual responsibilities do not lower your PR or system availability.

    • Example 1: An inverter was broken from February 21-22 and was not delivering values. A ticket was created for this, and you can now exclude this ticket cause.

    • Example 2: If a grid downtime on April 2 from 12:00-14:00 was documented in a ticket, you can exclude this ticket cause.

  • When an interval is excluded from the calculation, the corresponding chart will show nothing for that interval.

  • If a ticket that affects only one or several inverters is excluded from PR or System availability, only the affected inverters’ production is removed from system-level KPIs.

  • AUTOMATION Tip: To save time, use the Automation module to automatically create tickets with specific ticket causes. You can then configure the KPI Editor to always exclude these ticket causes.

Performance ratio with the KPI Editor

The performance ratio is calculated based on the system yield, installed DC power, and irradiation at the module plane. It indicates how well the PV system can convert solar energy. Typically, an annual PR value of 75-85% is considered good.

The KPI Editor allows you to:

  • Define different input parameters according to your needs

  • icon-plus2.png Create multiple PRs

  • icon-pencil1.png Edit and Delete PRs

  • image-20250627-095253.png Mark one PR as the main PR

  • icon-download1.png Export your calculation parameters and data as an Excel chart/spreadsheet

  • View the main PR in the Performance ratio chart

  • Compare the main PR with other PRs in the Performance ratio comparison chart.

    • Example: compare the PR stipulated in a contract with a technical PR.

Standard PR formula

The PR formula from IEC 61724-1 is used by default:

Default Performance ratio formula based on IEC 61724-1

Default performance ratio formula based on IEC 61724-1

Editable PR parameters with the KPI Editor

You can edit the following PR parameters with the KPI Editor. These settings affect the Performance ratio (PR) chart and the Performance ratio comparison chart.

Parameter

Description

Source of data

Energy must be defined as a term with the unit kWh.

Source of irradiance data

One of the following must be available:

  • A sensor that is defined as a term with the unit W/m² for irradiance at the module plane. See Terms.

  • Satellite data

Scope of data

Interval during which the PR is calculated.

We recommend Irradiance as threshold to exclude irrelevant intervals, as this works better on cloudier days.

Aggregation of data

Choose how to compile your data based on your requirements and/or contractual stipulations.

Excluded ticket causes

Choose which ticket causes should be excluded from the calculation.

Temperature compensation

The temperature source must be defined as a term with the unit °C for module temperature. See Terms.

Degradation

Add the annual degradation rate of your modules. This can be the same rate entered under Yield forecast, or a different rate.

Power control

Select the source of power control/curtailment. The available values are based on one of the following:

  • Correction value: set by the system operator

  • Setpoint value: set by the grid operator or energy trader

Once selected, the value will be factored into the calculation.

PR chart thresholds

You can define the thresholds for different performance levels (displayed as green, yellow, and red) that are reflected in the Performance ratio (PR) chart and Performance ratio comparison chart:

  • Portfolio-wide for every system: At the PORTFOLIO-LEVEL, go to icon-cog1(1).png Administration > icon-cogs1.png Customization > Design > Chart thresholds.

  • System-specific for each system separately: At the SYSTEM-LEVEL, go to icon-wrench1.pngSystem configuration > icon-stats-growth.png Calculations > Performance Ratio > PR chart thresholds.

System availability with the KPI Editor

System availability is the percentage of a system that is available over a period of time. It is an indicator of how quickly faults are identified and remedied.

Standard system availability formula

The following system availability formula is used by default:

image-20250627-125621.png

Default system availability formula

Editable PR parameters with the KPI Editor

You can edit the following system availability parameters with the KPI Editor. These settings affect the System availability chart and the Inverter availability chart.

Parameter

Description

Calculation method

System level: Monitor the energy of the entire system.

Inverter level: Tracks the power of every inverter. The individual values are then used to create an overall value.

Irradiance threshold

Set the minimum irradiance value required for system operation.

Source of irradiance data

Select whether your irradiance data comes from a Sensor or Satellite.

Excluded ticket causes

Choose which ticket causes should be excluded from the calculation.

Weighting by irradiance

This option gives more weight to intervals with higher irradiation levels. Instead of a simple time-averaged availability, the availability of each time interval is multiplied by the irradiance level during that period before averaging.

If you select this option, the weighted values are displayed in the charts. It is also possible to recalculate the values for historical data under Terms.

Weighting by irradiance is useful for comparing systems across different climatic conditions or identifying downtime issues that primarily affect high-production periods.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.