Processing math: 100%
Skip to main content

    Licensing

    In addition to the general licensed software metrics, additional metrics are defined for the CODESYS Visualization add-on. These metrics are checked during download.

    Important

    The CODESYS Visualization metrics are calculated during compile and the current value is displayed in the editor only afterwards.

    The determined values refer to one application. When multiple applications exist, the values of the individual applications are added up.

    Calculation of the software metrics

    Hint: First select your device and click the Edit Object command. In the device editor, select the Software Metrics for license determination tab. The current software metrics are displayed there quantitatively. The metrics of the CODESYS Visualization add-on are also described here.

    Software metrics

    _visu_icon.pngNumber of visualization tags

    Value of the metric in number of visualization tags

    The number of visualization tags is the sum of the tags across all applications. The number of tags of an application is the sum of the tags across all visualization objects.

    The number of IEC variables and the number of visualization elements are added together for each visualization object. The visualization element also takes into account the type, which is weighted with a certain number of tags.

    The following table shows what is counted with how many tags.

    Tags in Visualization

    Number of Tags

    Variable

    For a scalar variable (INT, WORD, REAL, STRING), one tag is counted.

    In the case of an array, each index is counted. In the case of structures. each variable in the structure is counted.

    A variable is counted only one time, even if it is used frequently in different visualizations.

    Local visualization variables and variables in the hotkey configuration are not counted.

    Trend, Trace, Histogram, Cartesian XY Chart

    For each curve, 100 tags are counted.

    Table

    For each cell, 1 tag is counted.

    All columns and only visible rows are taken into consideration. (number of tags = number of columns x visible cells)

    The cells of a template column are counted two times. (Use template option).

    Combo Box, Array

    For the Variable and for Data array properties, 1 tag is counted.

    In addition, one tag is counted for each column in the array.

    Alarm Table, Alarm Banner

    One tag is counted for each cell.

    All columns and only visible rows are taken into consideration.

    Frame

    Frames are typically used with an interface. If a frame is used with different instances, then the variables of the instances which are used by the frame are counted.

    Constants are counted like variables when they are passed to interface variables.

    Dialogs

    All dialogs which are opened by an input action are counted like a frame reference.

    System dialogs are counted with the following number of tags:

    • Number field: 5

    • Keyboard: 5

    • Text input with limitation: 5

    • Login: 5

    • Password change: 5

    • Configuration change: 20

    Native controls

    All scalar variables are counted.

    HTML5 controls

    All scalar variables are counted.

    Configured constants are counted like variables (colors, fonts, ...)

    If the type of the variable is ARRAY oder STRUCT, then the number of tags is calculated depending on the element size. A cell size is defined with a width of 50 pixels and a height of 30 pixels. This can typically be used to display an INT variable. The number of tags is calculated using the following formula (width a and height b in pixels).

    Equation 1.
    t=a50px⋅b30px


    Display software metrics (visualization license) as text

    The Visualization Tags View dialog gives you detailed information about the variables used for the visualization in the project, the determined number of tags, and the call position as the visualization path. These were used for the Number of visualization tags software metric based on your application.

    Visualization Tags View

    • Provides a detailed overview of the counted tags

    • Lists variables (tags) which are used in a specific visualization

    • Displays the call position as a visualization path

    For more information, see: Visualization Tags View

    Example 1. Example
    _visu_img_example_dialog_tags_view.png


    Filter function

    The visualization tags view with the Filtering by full or partial name filter function supports you with the following tasks and questions:

    • Where does a visualization object (template) occur?

      Example 2. Example

      Filtering by the call locations of the visualization object

      The SE_Infeed visualization is used in the _06_Settings visualization. And the _06_Settings visualization is called in the Visualization visualization.

      _visu_img_example_filter_for_call_positions_of_a_visu.png


    • Where does a tag (variable) occur?

      Example 3. Example

      Filtering by the call locations of a tag (variable)

      The Settings.iDirection tag (variable) is used in the SE_Infeed visualization.

      _visu_img_example_filter_for_call_positions_of_a_tag.png


    See also: