Asset State Timeline+

Overview

When to use it

Use this symbol when you need to:

• See the operating mode, machine state or batch phase of many assets on one time scale.
• Compare how much of the time each asset spent in a state, such as Manual.
• Follow an asset search as it changes, or narrow the assets with a filter symbol.
• Click an asset to show it on the rest of the display, or to open a detail display for it.
• Line up state changes with a trend of the same period.

Choose Asset Time Series Chart+ to trend numeric values across assets. Choose Gantt Chart+ when the bars come from event frames.

Before you begin

• Prepare AF assets that have the same attribute, usually from one element template. The attribute needs digital, enumeration or Boolean history.
• Configure PI Web API for Vision Library+. The symbol loads recorded history, so the account must be able to read the attributes.
• Keep the symbol within 100 rows, one for each asset and attribute.

Add and set up the symbol

1. Select Asset State Timeline+ in the PI Vision symbol gallery.
2. Drag the Mode attribute of an assembly line onto the display. The symbol shows one row.
3. Right-click the symbol and select Add Dynamic Search Criteria....
4. Expand Asset Name, enter Line ? and select Refresh. The ? stands for one character.

The symbol shows one row for each assembly line, in the display time range. The legend names the states that the rows show.

Common tasks

Show the time in each state

Use this when readers need a number as well as the bars, such as how long each line ran in Manual.

1. Right-click the symbol and select Configure Asset State Timeline+....
2. Under Attributes, expand % of Time in State.
3. Turn on each state you want to show, here Auto and Manual (1).

Each state gets a column. A figure is the share of the time with good data in the visible range, so it follows a zoom. Time without good data does not count against the state.

1. Click a column header (1) to sort the rows by it: the first click sorts lowest first, the second highest first, and the third returns to the configured order. The sort lasts for your session.
2. Hover a figure (2) to read the time in the state, the time with good data, and any gap.

The columns take at most about 40 percent of the width. A column that does not fit is left out, starting from the end of the state names in alphabetical order.

Choose which assets to show

Use this when the symbol shows too many assets, or the wrong ones.

1. Right-click the symbol and select Search Criteria....
2. Expand Asset Name (1) and enter a name. * stands for any characters and ? for one character.
3. Expand Number of Results (2) and enter the most assets you want.
4. Select Refresh (3).

The symbol shows the matching assets. Search Root, Asset Type and Asset Category narrow the search further, and Asset Order sorts the results.

Set the state colors

Use this when each state must have a color your readers already know. Without this step, the symbol gives each state name a color of its own.

1. Right-click the symbol and select Add Multi-State....
2. Select the attribute and select Enable Multi-State (1).
3. Set the color of each state in the States list (2).

The bars, the legend and the column headers take the colors. A state name has one color on every row. When assets number their states differently, the first row that has the state decides the color. A state you hide in the States list leaves a gap in the bars.

Narrow the symbol with a filter

Use this when operators choose assets by a value, such as the operating mode.

1. Place an Asset Filter+ on the display and list the Mode attribute.
2. Click a value in the filter, here Manual (1).

The symbol keeps the assets whose current value matches and shows the filter indicator (2). The filter can only narrow the assets that the search finds. To ignore the filter, open Filtering and turn Ignore Master on.

Open an asset with a click

Use this when clicking a row must show that asset on the rest of the display, or open a detail display for it.

1. Right-click the symbol and select Add Navigation Link....
2. Select Change context of current display (1) and keep Use current asset (2). To open another display, select Open hyperlink to another page instead and search for the display.

1. Close the pane and click a row, its label or its figures.

The display changes to that asset, and Asset (1) shows it. This symbol keeps its rows, so readers can choose the next one. A click on a toolbar button, a column header or the legend, and the end of a pan, do not follow the link.

Compare a period with a trend

Use this to look at the same period in the states and in the values, such as what a line's speed did while it ran in Auto.

1. Place a time-series chart, such as Asset Time Series Chart+, on the same display.
2. Click the plot to place ruler A (1), and click again for ruler B (2). When the symbol has a navigation link, hold Ctrl while you click.
3. Drag a handle to move a ruler.

The other chart shows the same rulers (3), and the plot outside them is shaded. Rulers placed on the other chart appear here too. To clear them, select Clear rulers on the toolbar.

Use the symbol

Interactions

• Hover a bar to read its state and times. Where several short states share one pixel, the bar shows the shortest of them and the tooltip lists them all with their durations. Hover a figure to read its times.
• Hover the plot to show a vertical line at the same time on the other time-series charts of the display. A line appears here when you hover one of them.
• Click the plot to place ruler A, then ruler B. Drag a handle to move a ruler, drag it off the plot or press Delete to remove it, or select Clear rulers. With a navigation link, a click follows the link and Ctrl+click places a ruler. Rulers are not saved.
• Double-click a row to open a popup trend of its attribute.
• Zoom with the mouse wheel, or with Zoom In, Zoom Out and Reset Zoom. Select Pan to drag the window, or Box zoom to drag across the period you want. The display time range follows when you release, and you can go past the loaded range.
• Fullscreen opens a larger view. Download saves a PNG, SVG or PDF image. An image has the bars and the figures, without the rulers.
• A live range shows a dashed marker at the current time.

Nothing in this symbol writes data to the PI System. Zoom and pan change the time range of the display, and a navigation link can change its asset. The symbol reacts to filter symbols and to a change of the asset context of the display.

Configure the symbol

Right-click the symbol and select Configure Asset State Timeline+... The pane sections appear in this order. Search Criteria..., Add Multi-State... and Add Navigation Link... open from the right-click menu.

Trend Options

Scales

Time Range

Start- and Endtimes is Display time range, Custom time range or Duration and offset. A changed range resets the zoom.

Time Bar

Enabled adds the shared Time Bar below the rows. Lock Time Bar keeps the symbol independent of later display time changes. Duration lists the ranges operators can choose.

Attributes

Current Attributes lists the attributes, and each makes one row per asset. The arrows reorder them. Modify Attribute List adds or removes attributes, and at least one stays. Only attributes with digital, enumeration or Boolean values are offered.

Filtering

Filter Indicator is Compact, Full or Hidden. Ignore Master ignores Master filters. Linked Inputs map another symbol's output channel to an asset property, and Asset Path is the safest property. See Filtering.

Search Criteria

Add Multi-State

Add Navigation Link

Troubleshooting and limitations

See Troubleshoot chart data loading for the PI Vision log and what to send to support.

Limitation: The symbol reads recorded values only, and it does not show string attributes or PI Points without AF.

Limitation: When assets number their states differently, a bar can differ from the color shown for that row in the States list.