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

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
- Select ProfileView+ in the PI Vision symbol gallery.
- Drag the zone PI Points or attributes onto the display. Each data source becomes one column.
- Set the display time range to the period to review, for example one reel.
- Right-click the symbol and select Configure Profile View....
- 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.
- Close the configuration pane. The symbol shows the zones from left to right and the time from top to bottom.


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.
- Right-click the symbol and select Configure Profile View.... Under General, open Coloring.
- Set Gradient to Diverging (Centered at Target) (1).
- Set Target to Custom (2) and enter the target value (3).
- 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.
- Optionally change Below Target, At Target and Above Target.

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.

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.

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

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.
- Right-click the symbol and select Configure Profile View.... Under Events, open General.
- Turn Enabled on (1) and set Mode to Selection (2).
- 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.

- Right-click the symbol and select Events Search Criteria....
- 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.

- 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).

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.

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

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).

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.
- Right-click the symbol and select Configure Profile View.... Under General, open Coloring.
- Set Gradient to OFF (Discrete) (1). Every value takes the color of the band it falls into.
- Right-click the symbol and select Configure Multi-State.... The pane lists the bands from Minimum to Maximum with their limits.
- Click the color of a band, for example Hi (2), and select another color from the palette.


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.

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

| 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
| Setting | What it does |
|---|---|
| Theme, Surface, Container Style, Apply to all symbols | Set the appearance. See Themes and container styles. |
| Font Size | Sets the size of the scale text and the tooltip. |
| Foreground, Background, Font | Set the text color, the background and the font. Available when Theme is Custom Theme. |
General: Coloring
| Setting | What it does |
|---|---|
| Gradient | OFF (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. |
| Deviation | Absolute or Percent distance from the target. Available when Gradient is Diverging. See Color the profile by its distance from a target. |
| Target | Custom 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, Fallback | The 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. |
| Range | Auto uses the loaded data range, MS the multi-state limits, Manual a distance from the target. |
| Value Range, Percent Range | The distance from the target at which the colors reach full strength. Available when Range is Manual. |
| Below Target, At Target, Above Target | The three colors of the diverging scale. |
Scales: Value
| Setting | What it does |
|---|---|
| Sort by | Default keeps the order of the data source list. Name sorts by zone name, with numbers in numeric order. |
| Show Scale | Shows or hides the zone axis. |
| Label Mode | Auto, Name or Number. Name prints the zone names, which suits a small number of zones. Number prints the position of the zone. |
| Tick Interval | Auto spaces the zone labels, Manual prints a label at the Interval you enter. Available when Label Mode is Auto or Number. |
| Show Histogram, Height | Shows 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 Mode | Absolute plots values, Deviation plots the distance from the target. With Gradient set to Diverging it is always Deviation. |
| Target | The target for Deviation. It is read-only when a multi-state source provides the target. |
| Target Line Color | The color of the target line. |
| Show Current Scan, Current Scan Color | Draws the newest scan as a line over the average profile. Available when Show Histogram is on. |
Scales: Time
| Setting | What it does |
|---|---|
| Show Scale | Shows or hides the time axis. |
| Show Histogram | Shows the strip of average values over time. Not available for digital data. |
| Display Mode, Target Value | Plot the strip as values or as distance from a target. Target Value is available when Display Mode is Deviation. |
Data Retrieval
| Setting | What it does |
|---|---|
| Mode | Interpolated reads values at evenly spaced times. |
| Interval Calculation | Auto 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 Time | Aligns the interpolated times to an hour, minute and second. Available when Interval Calculation is Manual. |
| Start- and Endtimes | Display 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
| Setting | What it does |
|---|---|
| General: Enabled | Turns reels on. The context menu then offers Events Search Criteria.... |
| General: Mode | Continuous plots the whole time range and marks the reels. Selection plots the reel you select. |
| General: Max Events | The most reels loaded. Default 100. |
| General: Auto Select | Manual or Latest Reel. Available when Mode is Selection. |
| Style: Start, End / Turnup, Region | Choose what is drawn for each reel. Region is available in Selection mode. |
| Style: Color Mode, Color | Custom uses one Color (default light blue), Severity colors by event severity, Auto gives each reel its own color. |
| Style: Line, Dash, Width | Draw the marker line. Dash 0 to 12, width 1 to 6. |
| Style: Labels, Background, Size | Show 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 Reel | Add time before the start and after the end of the selected reel. Available when Mode is Selection. |
Trace Options and Numbers
| Setting | What it does |
|---|---|
| Trace Options | Lists 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. |
| Numbers | Sets the number format of the scale labels and the tooltip values. |
Troubleshooting and limitations
| Symptom | Cause | What 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.
