Results
Introduction to KPI calculations
Description
The abbreviation KPI stands for Key Performance Indicator.
A KPI type is a formula made up of operands, constants and operators. The definition and calculation of KPI types are plant-specific.
Example of a KPI type:
-
Quality rate
A KPI instance can be created either during the widget configuration in the "Parameter" step or in the parameter list on the asset. The KPI instance can
-
be derived from a KPI type (typed)
-
or can be created typeless.
KPI types can be instantiated multiple times. When you make changes to the KPI type, these changes are also implemented in all KPI instances.
Automatically created KPI instances in the SIMATIC Energy Manager
KPI instances are created based on contract information for the individual energy media, the assigned variables, and KPI types as well as the reference mappings.
For automatically created KPI instances, you can define limits that trigger a notification when these limits are exceeded or not reached. The green check mark in the "Notifications activated" column shows that a notification has already been configured. More information on the configuration of notifications can be found here: "Activate notifications" for variables of the data type "Integer" and KPI instances.
In the parameter list, you can identify the automatically created KPI instances by the blue KPI icon:
Automatically created KPI instances do not generate any additional costs.
Operands
Operands serve as placeholders that are later filled with actual values from the variables. They are created when creating a KPI type and defined during the instantiation of the KPI type. Operands may contain no space, mathematical symbols or numbers at the beginning of the operand name. They can be moved and copied.
Structure of a KPI instance
The KPI instance is created as follows:
-
Instantiate a KPI type including linked variables or KPI instances (typed; multiple use is possible)
- or -
Create a KPI instance directly and link it to variables or KPI instances (typeless).
Each KPI instance must be assigned to an asset, but variables from other assets can also be linked to the KPI instance.
A KPI instance contains the following components:
-
Operands serve as placeholders that are later filled with actual values from the variables or KPI instances.
-
Constants can only contain numerical values
-
Operators
The following diagram shows the structure of the KPI type/instance concept:
NOTE
The KPIs are saved in a buffer (cache). If values were overwritten in MindSphere in the past (except for the current and last hour), it may take up to one hour before you will be able to see the data or KPIs and aggregations based on them.