TH NextGen - Adding, hiding and removing tags

Tags and attributes are the labels used to name time series data within a time series archive.

Analysis of data in TrendMiner starts with loading in your time series data in the form of tags or attributes. This article explains how to add, hide and remove tags or attributes.

Like all data, tags can be included or excluded from your analyses. They can also be cleaned, sorted, tested upon, and saved as a new tag. To ensure you have the right data sets in your analyses, it is essential to have an understanding of how to find, select, work on and save your tags or attributes. 

Tags and attributes are activated by adding them to your tags & attributes list.

This document includes:

  • How to add tags or attributes
  • Tag and attributes settings and options

How to add tags or attributes

One or multiple tags and attributes can be added to the active tag & attributes list via the "Search by asset or tag name"  search field located in the unified top bar.  Tags and attributes can be added by visualizing the asset structure defined by TrendMiner or the PI Asset Framework. You can easily navigate the plant structure and add tags attached to a specific asset. 

1. Click on the "Tags & attributes menu" button in the TrendHub menu.

2. Enter an asset or tag name into the search field.

Note: The quick tag search field will display all full or partially matching tags after typing in two characters.

Add1.png

3. From the results list of tags or attributes, click on the + icon to the left of the tag or attributes names to add the tag to the active tags & attributes list. Tags and attributes can also be added using your keyboard's arrows and return/enter keys. The + sign will turn green indicating that the tag or attribute has been added to your active tag list in the "TAGS & ATTRIBUTES" panel. The tag or attribute data will also display in chart form in the focus chart.

Add2.png Add3.png

4. Select a series of tags or attributes and click on the "ACTIVE" tag drop down menu to see the list of active tags. The TAGS & ATTRIBUTES list is situated left of the focus chart.

Add4.png

Tags and attributes can also be added via the "Saved views" tool as active components of a view. This tool is located in the TrendHub Menu Add5.png.

Note: TrendMiner indexes data from the historian, a tag will be indexed if it is loaded in TrendMiner for the first time. Indexing needs to be performed just once and the duration of indexing is dependent on the capacities of your historian server.

Note: wildcards (*) are available to specify more advanced naming patterns. e.g. 'C101*temp' will match all tags for which the tag name or description contains the strings 'C101' and 'temp', even if other characters appear in between.

Tags and attributes that have recently been used are also listed in the "RECENTLY USED" tag list. Simply click on the "RECENTLY USED" button situated at the base of the "TAGS & ATTRIBUTES" panel

You can resize the entire left menu bar so that you can read very long tag names.

Note: Hiding the menu panel is possible by clicking the close button or clicking again on the menu icon

Tag and attribute settings and options

In the active TAGS & ATTRIBUTES list you can click on any tag or attribute to open the details and settings panel.

Add6.png

How to hide tags or attributes

  1. Open the tags and attributes menu.
  2. Click on the eye icon Add7.png next to an active tag or attribute to toggle its visibility.

Hidden tags and attributes will stay in the active TAGS & ATTRIBUTES list, but will not be taken into account for some search-overview and will not be present on the chart.

How to remove tags or attributes

  1. Open the TAGS & ATTRIBUTES menu.
  2. Click on the remove icon Add8.png next to the active tag or attribute that you want to remove.

Deselected tags or attributes will be moved to the recently used TAGS & ATTRIBUTES list for quick access, in case you should need them again.

Deselected tags or attributes will be moved to the recently used TAGS & ATTRIBUTES list for quick access, in case you should need them again.

Note: There is also a clear all option under the 3 vertical dots at the top of the TAGS & ATTRIBUTES list Add12.png. Active list and recently used lists can be collapsed as well as cleared. 

Note: You can resize the entire tags and attributes panel, and others, so that you can read very long tag names. Simply click on the panel expansion bar and slide until your desired width is met.

Add9.png

How to change the color of a tag or attribute

  1. Click on the tag or attribute of interest to reveal details.
  2. Click on the colored circle top left of the details listing. A color palette will appear.
  3. Select the color of choice. 

Add10.png

Y Scale minimum maximum setting

When grouping tags or attributes within the focus chart in stacked mode, the groups are findable in the "TAGS AND ATTRIBUTES" panel. For details concerning the axis please refer to this document.

Shift tool

You can shift chart by clicking on one of the four shift buttons.

Add11.png

The shift corresponds to:

  • For the layer shifting the values are:
    • Big shift: 5%
    • Small shift: 0.5%
  • The default shift option (options under the focus charting)
    • 20% (left or right shift)

Limitations 

Following functional changes have been implemented: 

  • The query requires a minimum length of 3 characters. 
  • First 200 results are returned. 
  • Results are sorted on name (ascending). 
  • Debounce is increased. 

Note: for a tag consisting of 2 characters, use the wildcard or the advanced search. 

Eg: 

Tag name = XY 

Search query = XY*