Documentation Vision Library+ Documentation

ProfileView+

ProfileView+ shows a cross-direction measurement profile over time. Each data source is one zone across the machine, time runs down the display, and each cell is colored by its value or by its distance from a target. Operators spot streaks, heavy edges and drift on a paper machine or another continuous web, and compare one reel with the next.

Overview

ProfileView+ showing a moisture profile of 1,000 zones over one reel, colored by distance from a target of 50

Watch the demo

See ProfileView+ in a practical PI Vision workflow.

When to use it

Use this symbol when you need to:

  • Watch a scanner profile such as moisture, basis weight or caliper across the machine, one row per scan.
  • Find streaks, heavy edges and drift by color.
  • See which zones run above or below a target.
  • Review a finished reel, or the reel in progress, one at a time.
  • See where reels start and end on a longer time range.

Choose Heatmap+ to compare unrelated signals across time buckets. ProfileView+ keeps the zones in their physical order and adds an average profile, a current scan and a reel selector.

Before you begin

  • Use one numeric PI Point or AF attribute for each zone, with the same data type and unit. The first data source in the Trace Options list sets the data type, unit and multi-state limits for the whole symbol.
  • To work with reels, have an event frame for each reel in an AF database. A reel can carry a target attribute.
  • Configure PI Web API for Vision Library+. The symbol loads its own history.
  • Use a short time range, such as one reel. The symbol loads one row per interval for every zone, up to the height of the symbol, so a long range with many zones loads slowly.

Add and set up the symbol

  1. Select ProfileView+ in the PI Vision symbol gallery.
  2. Drag the zone PI Points or attributes onto the display. Each data source becomes one column.
  3. Set the display time range to the period to review, for example one reel.
  4. Right-click the symbol and select Configure Profile View....
  5. Under Scales, open Value and set Sort by to Name (1). This puts the zones in numeric order, so Zone 2 comes before Zone 10. Leave it on Default to keep the order of the data source list.
  6. Close the configuration pane. The symbol shows the zones from left to right and the time from top to bottom.
Value group with Sort by set to Name
ProfileView+ after the quick start, with the average profile under the heatmap

Under the heatmap, the average profile shows each zone's average over the time range. The colors come from the multi-state limits of the first zone. To check or change the zone order, open Trace Options in the configuration pane and use the arrow buttons.

Common tasks

Color the profile by its distance from a target

Use this when operators ask which zones run above or below the target. Zones at the target take the At Target color, white by default, and zones above and below take two other colors.

  1. Right-click the symbol and select Configure Profile View.... Under General, open Coloring.
  2. Set Gradient to Diverging (Centered at Target) (1).
  3. Set Target to Custom (2) and enter the target value (3).
  4. Set Range to Manual (4) and enter a Value Range (5). Colors reach full strength this far from the target: with a target of 50 and a range of 25, the scale runs from 25 to 75.
  5. Optionally change Below Target, At Target and Above Target.
Coloring group with a custom target of 50 and a manual value range of 25

The heatmap shows red where the zones run above the target (1) and blue where they run below it (2). The target value appears on the scale of the average profile (3), and the profile is drawn around it.

ProfileView+ colored by distance from a target of 50, with callouts on a red zone, a blue zone and the target on the scale

Deviation chooses what the distance means: Absolute is the difference in the unit of the data, Percent is the difference in percent of the target. Range set to Auto uses the range of the loaded data, and MS uses the multi-state limits.

If every reel has its own target, set Target to Event (2). The symbol reads the attribute named in Event Attribute (3) from the selected reel. It uses the Fallback (4) when the reel has no such attribute or no reel is selected. This needs the Selection mode described in Review one reel at a time.

Coloring group with the target read from the Target attribute of the selected reel

Show the average profile and the latest scan

Use this to compare the newest scan with the average profile of the period, and to see the average of all zones over time.

  1. Right-click the symbol and select Configure Profile View.... Under Scales, open Value.
  2. Turn Show Histogram on (1). The average profile appears under the heatmap. Set its Height (2).
  3. Set Display Mode (3) to Absolute to plot the values, or to Deviation to plot the distance from the target.
  4. Turn Show Current Scan on (4) and choose a Current Scan Color (5).
  5. To plot the average of all zones for each point in time, open Time and turn Show Histogram on.
Value group with the histogram and the current scan turned on

The average profile (1) shows each zone's average over the time range, in the colors of the scale. The line (2) is the newest scan. The strip to the left of the time axis (3) is the average of all zones at each time.

ProfileView+ with the average profile, the current scan line and the time average strip marked

Where the line leaves the average profile, the newest scan differs from the average of the period.

Review one reel at a time

Use this when operators judge each reel separately. The selector lists the reels, and the symbol plots the reel you pick.

  1. Right-click the symbol and select Configure Profile View.... Under Events, open General.
  2. Turn Enabled on (1) and set Mode to Selection (2).
  3. Optionally change Max Events (3), the most reels the selector loads. Set Auto Select (4) to Latest Reel to plot the newest reel automatically. Manual waits for a choice.
Events General group with Selection mode and Auto Select
  1. Right-click the symbol and select Events Search Criteria....
  2. Check that Database (1) names the AF database with your reels and that Event Type and Attribute Value (2) is set to the reel template. Keep Search Mode (3) on Events Active in Time Range and select Apply.
Events Search Criteria pane with the database, the event type and the search mode marked
  1. To show the time before and after each reel, open Padding, turn Use Padding on (1) and set Before Reel (2) and After Reel (3).
Padding group with one minute before and after the reel

A selector appears at the top of the symbol. It lists the reels found in the symbol's time range, which is the display time range unless you set Start- and Endtimes under Data Retrieval. The symbol plots the selected reel, with the padding around it, and ignores the display time range for the plot.

ProfileView+ with the reel selector open, the selected reel shaded and one minute of padding around it

The selector has a button that collapses it (1), a search box (2), buttons for the previous and next reel (3) and a button that clears the selection or, with Latest Reel, returns to the newest reel (4). Select a reel in the list (5) to plot it. The shaded region (6) is the reel and the padding is the unshaded part around it.

Mark reel starts and ends on a time range

Use this when you want one long profile and need to see where each reel began and ended.

  1. Right-click the symbol and select Configure Profile View.... Under Events, open General.
  2. Turn Enabled on and set Mode to Continuous.
  3. Right-click the symbol and select Events Search Criteria... to choose the reels, as in Review one reel at a time.
  4. Open Events > Style. Select Start (1) and End / Turnup to draw the markers.
  5. Choose a Color Mode (2). Auto gives each reel its own color, Custom uses one color and Severity colors by event severity.
  6. Set the Line (3) and the Labels (4) as needed.
Events Style group with start and end markers, color mode Auto, line and labels

The symbol plots the whole time range and draws a labeled line at the start (1) and the end (2) of each reel. The next reel starts in its own color (3).

ProfileView+ over six minutes with the markers of two reels

Region shades the area of the reel. It is available in Selection mode only.

Color the profile in threshold bands

Use this when the decision is whether a zone is inside a band, not how far it is from a value. Each band has one flat color.

  1. Right-click the symbol and select Configure Profile View.... Under General, open Coloring.
  2. Set Gradient to OFF (Discrete) (1). Every value takes the color of the band it falls into.
  3. Right-click the symbol and select Configure Multi-State.... The pane lists the bands from Minimum to Maximum with their limits.
  4. Click the color of a band, for example Hi (2), and select another color from the palette.
Coloring group with Gradient set to OFF (Discrete)
Configure Multi-State pane with the multi-state source (1) and the color of the Hi band (2) marked

The heatmap and the average profile use flat bands in the colors of the multi-state. The limits come from the multi-state source shown under Multi-State Source.

ProfileView+ in discrete mode with the Hi band in yellow

Smooth (RGB) and Smooth (Perceptual) blend between the limit colors. Smooth (Perceptual) corrects the blend so that transitions look more even.

Use the symbol

ProfileView+ with numbered callouts and a tooltip
What it shows
(1)The heatmap. Each column is one zone, in zone order from left to right. Each row is one scan, with the oldest at the top.
(2)The time axis.
(3)The zone axis. It shows zone numbers or names, depending on Label Mode.
(4)The average profile: each zone's average over the plotted time range, drawn on the color scale.
(5)The current scan, the newest row drawn as a line.
(6)The tooltip with the time, the zone number and name, and the value with its unit. The boxes on the axes show the average of all zones at that time (left) and the average of that zone over the range (bottom).
  • Hover the heatmap to see the tooltip and the crosshair. Over a reel marker the tooltip adds the reel name, start, end and duration.
  • Click a reel marker to open the PI Vision Event Details of that reel. The dialog has an Edit button, which changes the event frame in AF. The symbol itself writes nothing.
  • Pick a reel in the selector to plot it. The choice applies to this symbol and is not saved with the display.
  • No data: a cell without a good value takes the Bad data color of the multi-state, and the tooltip shows No Data.
  • Digital data is colored by state, with a legend at the top right. It has no histograms and no current scan.

Configure the symbol

Right-click the symbol and select Configure Profile View.... The pane has the sections General, Scales, Data Retrieval, Events, Trace Options and Numbers. The Events section shows its Style and Padding groups when events are enabled.

General: Style

SettingWhat it does
Theme, Surface, Container Style, Apply to all symbolsSet the appearance. See Themes and container styles.
Font SizeSets the size of the scale text and the tooltip.
Foreground, Background, FontSet the text color, the background and the font. Available when Theme is Custom Theme.

General: Coloring

SettingWhat it does
GradientOFF (Discrete) colors by band. Smooth (RGB) and Smooth (Perceptual) blend between limit colors. Diverging (Centered at Target) colors by distance from a target. See Color the profile in threshold bands.
DeviationAbsolute or Percent distance from the target. Available when Gradient is Diverging. See Color the profile by its distance from a target.
TargetCustom uses the value you enter. MS uses the target of the multi-state. Event reads an attribute of the selected reel. Available when Gradient is Diverging.
Event Attribute, FallbackThe reel attribute that holds the target (default Target) and the target to use when the reel has none: MS or Custom. Available when Target is Event.
RangeAuto uses the loaded data range, MS the multi-state limits, Manual a distance from the target.
Value Range, Percent RangeThe distance from the target at which the colors reach full strength. Available when Range is Manual.
Below Target, At Target, Above TargetThe three colors of the diverging scale.

Scales: Value

SettingWhat it does
Sort byDefault keeps the order of the data source list. Name sorts by zone name, with numbers in numeric order.
Show ScaleShows or hides the zone axis.
Label ModeAuto, Name or Number. Name prints the zone names, which suits a small number of zones. Number prints the position of the zone.
Tick IntervalAuto spaces the zone labels, Manual prints a label at the Interval you enter. Available when Label Mode is Auto or Number.
Show Histogram, HeightShows the average profile and sets its height in pixels (40 to 800, default 140). Not available for digital data. See Show the average profile and the latest scan.
Display ModeAbsolute plots values, Deviation plots the distance from the target. With Gradient set to Diverging it is always Deviation.
TargetThe target for Deviation. It is read-only when a multi-state source provides the target.
Target Line ColorThe color of the target line.
Show Current Scan, Current Scan ColorDraws the newest scan as a line over the average profile. Available when Show Histogram is on.

Scales: Time

SettingWhat it does
Show ScaleShows or hides the time axis.
Show HistogramShows the strip of average values over time. Not available for digital data.
Display Mode, Target ValuePlot the strip as values or as distance from a target. Target Value is available when Display Mode is Deviation.

Data Retrieval

SettingWhat it does
ModeInterpolated reads values at evenly spaced times.
Interval CalculationAuto sets the interval from the time range and the height of the symbol, never below one second. Manual sets the Interval yourself. A small interval over a long range loads a large amount of data.
Sync TimeAligns the interpolated times to an hour, minute and second. Available when Interval Calculation is Manual.
Start- and EndtimesDisplay time range follows the display. Custom time range takes a fixed start and end. Duration and offset sets a length and an offset from the display end time, for example the previous shift.

Events

SettingWhat it does
General: EnabledTurns reels on. The context menu then offers Events Search Criteria....
General: ModeContinuous plots the whole time range and marks the reels. Selection plots the reel you select.
General: Max EventsThe most reels loaded. Default 100.
General: Auto SelectManual or Latest Reel. Available when Mode is Selection.
Style: Start, End / Turnup, RegionChoose what is drawn for each reel. Region is available in Selection mode.
Style: Color Mode, ColorCustom uses one Color (default light blue), Severity colors by event severity, Auto gives each reel its own color.
Style: Line, Dash, WidthDraw the marker line. Dash 0 to 12, width 1 to 6.
Style: Labels, Background, SizeShow the reel name on the marker, with or without a background, and set the text size from 8 to 18.
Padding: Use Padding, Before Reel, After ReelAdd time before the start and after the end of the selected reel. Available when Mode is Selection.

Trace Options and Numbers

SettingWhat it does
Trace OptionsLists the zones in order. Select one and use the buttons to move it up, down, to the top or to the bottom, or to delete it. The first data source sets the data type, unit and limits.
NumbersSets the number format of the scale labels and the tooltip values.

Troubleshooting and limitations

SymptomCauseWhat to do
The profile looks scrambled or noisy.The zones are not in machine order, for example Zone 10 comes before Zone 2.Set Sort by under Value to Name, or reorder the zones under Trace Options.
The symbol is empty and the selector says No reel selected.In Selection mode the symbol plots a reel only after you select one.Select a reel in the list, or set Auto Select to Latest Reel.
The selector says No reels found.No reel lies in the symbol's time range, or the search criteria do not match.Widen the time range, and check Events Search Criteria....
The symbol loads slowly or the browser stops responding.Many zones over a long range create many rows.Shorten the time range, plot one reel, or set Interval Calculation to Manual with a larger interval.
Show Current Scan is missing.It needs Show Histogram under Value and numeric data.Turn Show Histogram on.
Target under Value cannot be edited.A multi-state source provides the target.Change the target in the multi-state, or set Gradient to Diverging with a Custom target.
The colors ignore the target of the reel.Target is Event, but no reel is selected or the reel has no attribute with that name.Select a reel in Selection mode and check Event Attribute. Otherwise the Fallback applies.

Limitation: The symbol reads interpolated values only. It does not plot the recorded values of a PI Point.

Limitation: All zones share the data type, unit and limits of the first data source.

Limitation: The average profile, the current scan and the time strip are not available for digital data.