Kaspersky Machine Learning for Anomaly Detection

Creating a virtual tag

You can create virtual tags in Kaspersky MLAD.

To calculate the real and predicted values of a virtual tag, and the virtual tag error, you can define expressions with simple arithmetic operations (such as addition, subtraction, multiplication, and division), calculation of the square root (the sqrt function) and exponentiation (using the ^ character). You can use the following variables in your expressions:

• $tag is the value of the tag based on which the value of the virtual tag is calculated.
• $tagX is the X coordinate of the monitored asset's sensor location.
• $tagY is the Y coordinate of the monitored asset's sensor location.
• $tagZ is the Z coordinate of the monitored asset's sensor location.

For example, you can specify an expression to calculate the Celsius temperature based on the tag that receives the Fahrenheit temperature:

The values of the virtual tag will be displayed on the graphs in the Monitoring and History sections in accordance with the specified expression.

To create a new tag:

1. In the administrator menu, select Tags.
2. In the upper part of the page, click the Create button.

   The Create tag pane opens on the right.

3. In the Tag type drop-down list, select Virtual tag.
4. If necessary, click the Choose an icon button and select an icon for the virtual tag in the opened window.

   You can upload the tag icon by clicking the Load icon button. Images of any format larger than 128x128 pixels are shrunk to 128x128 while maintaining the aspect ratio. The size of the uploaded image in SVG format must not exceed 200 KB.

   If you need to delete the tag icon, click the tag icon and then click Delete in the opened window.

5. In the Group drop-down list, select the tag group to which you want to assign the created virtual tag.

   Tag groups must be previously loaded or created manually.

6. in the Name field, specify the virtual tag name.
7. In the Description field, specify the virtual tag description.
8. In the ID field, specify the virtual tag ID.
9. In the Dimension field, specify the measurement units for the virtual tag.
10. In the X, Y, and Z fields, specify the spatial coordinates for the location of the monitored asset's sensor.

    You can use an arbitrary point as the origin of the coordinate system.

    You can use sensor coordinate values to calculate virtual tag values and display them on graphs in the Monitoring and History sections.

11. In the Class to display field, specify the class for displaying the virtual tag.
12. In the Technical limits section, in the Lower and Upper fields, specify the lower and upper limits for the virtual tag values.

    These settings are required for correct operation of the Limit Detector. Whenever the tag value reaches its upper or lower technical limit, the Limit Detector registers an incident.

    If the Always show technical limits option is enabled, the vertical scale of the graph will be defined by limit lines drawn at the lower and upper boundaries of the tag graph, provided that the tag values are within the specified range. If the tag values go beyond the specified limits, the vertical scale will be automatically changed to display the tag values exceeding the limits.

13. In the Display boundaries section, in the Lower and Upper fields, specify the lower and upper limits for displaying the virtual tag values on the graphs.

    If tag values go beyond the defined boundaries, they will not be displayed on the tag graph. The permissible boundaries for displaying tag values take priority over the display of technical limits, even if the Always show technical limits function is enabled.

14. In the Asset field, specify the name of the asset created in the external system, for which you need to calculate the virtual tag values.
15. If you need to add additional horizontal threshold lines for this tag on graphs in the Monitoring and History sections, click the Add line button and use the Threshold value field to enter the value that should be displayed on the graph.

    Additional horizontal threshold lines help visually evaluate the fluctuations of tag values within certain limits. You can add multiple additional horizontal threshold lines.

16. To display the values of a virtual tag on the graphs in the Monitoring and History sections, perform the following actions in the Tag calculation expression group of settings:
    1. In the Calculation tag ID drop-down list, select the ID of the tag based on which you want to calculate the value of the virtual tag.
    2. In the Expressions for calculating actual and predicted tag values drop-down list, select one of the following values:
       • If you want to use the same expressions to calculate the actual and predicted tag values, select Identical expressions.
       • If you want to use different expressions to calculate the actual and predicted tag values, select Different expressions.
    3. In the Expression for calculating tag values field, specify an expression for calculating tag values.

       This field is displayed if you chose to calculate actual and predicted tag values using the same expressions.

    4. In the Expression for calculating actual tag values field, specify an expression for calculating actual tag values.

       This field is displayed if you chose to calculate actual and predicted tag values using different expressions.

    5. If necessary, enter a tag value calculation expression for predicted values in the Expression for calculating predicted tag values field.

       This field is displayed if you chose to calculate actual and predicted tag values using different expressions.

    6. If necessary, enter an expression for error calculation in the Error calculation expression field.
17. Click the Create button.

The new tag will appear under Tags in the tag tree on the left. If necessary, you can change the position of tags in the tag tree. To do this, drag the required tag up or down in the tag tree by the three horizontal lines () to the left of its ID.