Tag Management
About Tags
Tags are used to store the data for specific properties of an asset (for example, boiler pressure, condenser pressure).
Using Analysis V2, you can plot tag data on various types of charts to analyze them.
When you access an analysis view, the following sections are available on the right side of the page:
- The Tag Browser section: Contains a list of all the tags and tag groups associated with the selected asset (along with tag expressions, if any). In the Tag Browser section:
- You can add additional assets as needed except for an Event Data Analysis.
- For SmartSignal tags, the modes and models for both active and inactive tags appear, whereas for other tags, input and output tags appear.
- You can mute or unmute tags globally.
- Tag groups appear based on their ordinal number (if assigned in the template) or alphabetical order.
- The Plotted Tags section: Contains a list of all the tags that are plotted on charts.
Icon Purpose Provides the names of the cards on which a tag is plotted Provides the names of charts on the associated card Indicates tags that are associated with the selected asset during ingestion Indicates tags that are related to the selected asset, such as wind speed or power output of the asset Indicates that data is not available for the tag Note: You can plot tags with no data for a specified time range. The tag appears in the Plotted Tags section but is disabled. When the date range is changed to include the tag data, it appears as enabled and the data is plotted.Indicates a tag expression, which is a calculation that include tags related to the selected asset Indicates a group of designated related tags created during ingestion of the selected asset that can be plotted simultaneously Indicates a static value created as a marker to compare with the performance of other tags plotted on the chart Indicates a power curve tag created to assess performance for tags used in an X-Y chart Indicates SmartSignal tags that are associated with the selected asset during ingestion Indicates tag groups associated with the asset Indicates tags that have been removed from the asset or that you do not have access to the asset associated with the tag Provides access to the tag settings such as the line style, color, and unit of measure for tags and charts that do not use pairs of tags - The Tag Expressions section: Contains a list of tag expressions (that is, simple calculations created using other tag or tag expressions).
Scenario | Outcome |
---|---|
Add a tag with no data for the current date range to a chart. | No data is plotted on the chart, and the tag name is displayed as disabled with an ND (no data) indicator in the plotted tag list. |
Access a chart saved with tags containing no data for the current date range. | No data is plotted on the chart, and the tag name is displayed as disabled with an ND (no data) indicator in the plotted tag list. |
Change the date range for a chart containing tags with no data, allowing data to become available. | The tag data is plotted to all charts that use the tag, and the tag name is displayed as enabled in the plotted tag list. |
Change the date range for a chart containing tags with data, making data unavailable. | No data is plotted on the chart, and the tag name is displayed as disabled with an ND (no data) indicator in the plotted tag list. |
Access a class-level template and the current class instance does not contain one or more of the tags that have been saved in the template. | No data is plotted on the chart, the tag name is displayed as disabled with an ND (no data) indicator in the plotted tag list, and text for each tag that tells the user the tag is not configured. Format of text is "Not configured for < name of current asset instance>." Tags saved with the template that do not exist for the current asset are not plotted even if data is present for the asset or tag. |
About the Tag Browser
The Tag Browser allows you to find tags, view tag information, and plot tags.
The Tag Browser loads the in-context asset and its associated tags by default. You can add additional assets and their associated tags to the Tag Browser. You can view up to 250 tags in the Tag Browser.
You can plot SmartSignal Model groups and tags from the Tag Browser.
- The asset currently in context.
- The asset attributes associated with the selected asset. Listed asset attributes are restricted to Reference attributes only.
- The tag expressions associated with the selected asset.
- The plotted tags for the selected view.
- The tag groups associated with the asset.
- The tag groups that have been deployed.
- The SmartSignal analytics provide Modes and Models for both active and inactive tags.
- The non-SmartSignal analytics provide Input Tags and Output Tags.
- When you hover over the Analytic name, the Analytic deployment name appears.
You cannot add additional assets for Event Data Analysis charts in the Tag Browser, Tag Expressions, or Search Browser panes.
The Tag Browser and Plotted Tags appear in the Tag Panel for both SmartSignal and Analysis V2 cards. The Asset node in the Tag Browser expands to display the All Tags node, the Analytics node, and the Tag Expressions node. Child-Asset nodes are expandable. The Tag Expressions node can be expanded to reveal the relevant tag expressions for the asset context. To view the tag details in a tool tip, hover over a tag in the Tag Browser or in Plotted Tags. The Analytics node expands to display model groups, which also expand to display groups of tags that can be plotted. Tool tips are not available for nodes.
When you use search in the Tag Browser, tags within the selected assets are highlighted as you enter characters.
When you select a view, any tags that are currently plotted in the view appear in Plotted Tags.
- Plot tags, analytics groups and tags, and tag expressions to the charts for the selected view.
- Globally mute or unmute tags that appear on the charts for the selected view.
- Access tag information.
- Add and remove multiple assets and their associated tags.
- Search the Tag Browser by tag name or description.
- View tag groups associated with the asset in the tag tree. Note: The Analytic tag groups appear in the order of their ordinal numbers in the Analytic Groups section of the Tag Browser, when the tag groups are assigned ordinal numbers in the Analytics template. However, if the Analytic tag groups do not have any ordinal numbers assigned in the Analytics template they appear in the alphabetical order in the Tag Browser.
In Analysis V2 charts, you can drag up to 60 tags to a Time Series, Spiderweb, or Parallel Axis chart in the view singly or in groups. The X-Y and Polar charts are limited to two or three tags per chart, respectively. Double-clicking the heading of Plotted Tags collapses it. You may need to scroll to see all items in a long list of tags in the Tag Browser.
In SmartSignal charts, you can drag up to 60 tags to a Time Series chart in the view singly or in groups.
Removing an asset from the tree does not affect tags already plotted; however, tag expressions listed in the tree may become invalid. The primary asset cannot be removed.
Nodes and tags listed in the Tag Browser appear as specific icons depending on the type of tag:
Search for Asset Tags
About This Task
- You can use modifiers to build the search query.
- The assetSourceKey, which is the assetID, is the default context prefix modifier that is used for unique searches. You can also use the assetName as the context prefix modifier if you want to search based on asset names.
- You can enter special characters in the search criteria to search for tag names with special characters. When you type the special characters asterisk (*), colon(:), and backslash(\) in the Search box as part of the search criteria, you must type a backslash(\) before these characters to escape them. Otherwise, the special characters are displayed as different characters than expected. However, when you copy and paste tag names with these special characters in the Search box, the backslash(\) is added before the specific characters by default. You do not have to add them manually.
- Wildcard search and usage of modifiers is not supported if you copy and paste the search criteria.
- A maximum of 250 results is displayed at a time. You can select the maximum number of results to be displayed per page, 40 or 100. Tip: If your search returns more than 250 results, a hint appears to refine your search.
- If available, correlated tags and units of measure are displayed in the search results for a tag.
Procedure
Plot Tag Groups Associated with an Alert
About This Task
The tag groups are defined as part of the SmartSignal Analytic Templates.
Procedure
Plot Tags for Time Series Analysis Charts
About This Task
The following conditions apply when you plot tags:
- You can plot up to 70 tags in a Time Series Analysis chart. For an X-Y chart, you can plot only 2 tags, whereas for a Polar chart, you can plot up to 3 tags.
- You can use pre-defined analysis templates to plot tags. Alert Analysis charts contain pre-plotted tags that depend on the analysis template, which is part of the alert template associated with the alert.
- The source UoM is converted to the standard UoM.
- Each plotted tag is identified by a unique color, which matches the color of the tag data plotted on the chart. Plotted tags with no data and tags that are not configured do not have a color.
- Tags that are not configured for an asset or do not have any data do not appear on the chart or the tag register. These tags appear only in the Plotted Tags section on a chart with a not configured (NC) or a no data (ND) indicator.
Procedure
Plot Tags for Event Data Analysis Charts
About This Task
The following conditions apply when you plot tags:
- The source UoM is converted to the standard UoM.
- Each plotted tag is identified by a unique color, which matches the color of the tag data plotted on the chart. Plotted tags with no data and tags that are not configured do not have a color.
- Tags that are not configured for an asset or do not have any data do not appear on the chart or the tag register. These tags appear only in the Plotted Tags section on a chart with a not configured (NC) or a no data (ND) indicator.
- You can plot up to 70 tags in an Event Data Analysis chart.
Procedure
Plot SmartSignal Model Group Tags
About This Task
Procedure
Plot a Reference Curve
You can compare actual data points on an X-Y chart with a plotted power curve to assess performance.
About This Task
The following conditions apply when you plot a reference curve:
- You can add a reference curve tag to an X-Y chart as part of a tag series. The Plotted Tags section displays a hierarchy of the cards, charts, and tags that are plotted on a chart. Plotted tags for an X-Y chart are displayed in the Plotted Tags section as tag series.
- You can remove a tag series from an X-Y chart in both Time Series Analysis and Event Data Analysis views.
- You can filter tags in reference curves as well.
- You cannot drag and drop a tag series in the Plotted Tags section.
- Additional tag series plotted on a chart must match the UoMs of the tag series already plotted.
- Removing tags that are plotted on multiple charts in a view affects all the charts in the view.
- You must plot tags associated with a power curve because the tag type is not validated.
Procedure
View/Export Tag Data in a Table
About This Task
Procedure
Access All Generated Alerts for a SmartSignal Asset
You can access one or more Alerts for an asset or a group of assets along with the contributing and non-contributing tags associated with the generated Alerts.
About This Task
- Alerts are listed in order of severity, indicated by the severity number and a color code.
- Both the contributing tags (tags that directly contribute to the Alert) and non-contributing tags (tags that are a part of the asset but are not contributing to the Alert) appear.
- When alerts occur, the affected Analytic name, Analytic Tag, mode, model, group, or tag icons are indicated in red color, along with the parent node that is related to the affected tag.
- Assets may include additional generated Alerts, along with the ready or in-progress tags from generated Alerts for all the associated assets.
Procedure
Access On-Monitor Tags for SmartSignal
About This Task
Procedure
Access the Tag Values in Scientific Notation
You can switch between standard and scientific notation for Y-axis tag values on a chart.
About This Task
Procedure
Remove a Tag
About This Task
Removing tags that exist on multiple charts in a view affects all the charts in the view.
Procedure
Add Multiple Y-Axes to a Chart
About This Task
- You can add multiple Y-axes only if you select the one-up card layout.
- Tags with different UoM create different Y-axes.
- You can add up to six Y-axes to a chart - three on either side of the chart.
- If you plot a single tag series, the tag name appears on the Y-axis. Tag series is created when two tags are plotted for an X-Y or Polar chart.
Procedure
Add Additional Assets
About This Task
- When you select an asset from the Asset Hierarchy, only the primary assets appear. However, the Tag Browser section contains both primary and secondary assets.
- You cannot add additional assets for Event Data Analysis charts.
- You can only remove secondary assets in an analysis view; you cannot remove the primary assets.
- When you remove an asset, you can choose whether to remove any previously plotted tags for this asset from the Plotted Tags section and the charts.
- You cannot remove assets with tag expressions that are plotted on a chart.
Procedure
Compare Tag Data of Multiple Assets
About This Task
- The assets whose data you want to compare must contain similar tags; otherwise, a message appears, stating that matching tags are not found.
- Tag expressions containing multiple assets are not supported.
Procedure
Rename a Tag Series
About This Task
Procedure
Focus on a Tag Series in a Chart
About This Task
- Muted tags are unmuted when they appear.
- Templates containing multiple tag series do not save the order in which the series appears.
- If the tags overlap with one another, the last one that was plotted will be visible on the chart.
Procedure
Mute/Unmute Chart Data
About This Task
Even after you mute a tag, the color assigned to the tag is retained after you unmute.