Combo Chart+
Combo Chart+ trends several PI Points or AF attributes on one time axis. Each data source gets its own trace type and value scale, and you can add equipment states, limits, event frames and a table of statistics.
Overview

Watch the demo
See Combo Chart+ in a practical PI Vision workflow.
When to use it
Use this symbol when you need to:
- Trend values together as lines, areas or bars, each on its own value scale when their units differ.
- Show equipment states such as running, stopped or failure next to a measurement.
- Investigate a period: zoom in, place two rulers and read the average, minimum and maximum between them.
- Color a value by limits and draw the limit lines.
- Relate process changes to event frames.
Choose Asset Time Series Chart+ to plot the same attributes for every asset found by an asset search. Choose Period Comparison Chart+ to compare one value in different periods, and Control Chart+ to judge statistical control.
Before you begin
- Use PI Points or AF attributes. Line, area, bar and scatter traces need numeric values. Digital, enumeration and Boolean sources show states, and string sources show text markers.
- Configure PI Web API for Vision Library+. The chart loads its own history, and the summary table and event frames use the same connection.
- Values that share a value scale or a range area should have the same unit. An AF attribute can be shown in another unit of the same kind with Display unit.
- To create event frames you need an AF database, an event frame template and write permission.
Add and set up the symbol
- Select Combo Chart+ in the PI Vision symbol gallery.
- Drag the first data source onto the display, for example a tank level. Drag a second one onto the chart, for example a feed rate.
- Right-click the chart and select Configure Combo Chart....
- Under Data Retrieval, set Mode to Interpolated and Interval to
20Minute. This gives one value per interval, which keeps a fast signal readable. - Under Trace Options, select each data source in the list and enter a Label.
- Close the pane. The chart shows one trace per data source, each on its own value scale, and the legend shows the latest values.

A new chart starts with Mode on Default, which suits slow signals.
Common tasks
Show values as lines, areas and bars
Use this when a value reads better as a filled area or as columns, for example a quantity per interval.
- Right-click the chart, select Configure Combo Chart... and scroll to Trace Options.
- Select the data source in the list (1).
- Set Type (2) to Line, Area, Bar, Scatter or Range Area. Here the tank level is an area and the feed rate is a bar.
- Under Data Retrieval, keep Mode on Interpolated, or choose Summary and an Interval. Neighboring bars then cover equal intervals.

The tank level is drawn as a shaded area and the feed rate as columns, each on its own scale.

An unstacked area scales to its data like a line. Bars and stacked areas keep zero on their scale. To start an area at zero, set Scale Range to Custom with Minimum 0. Set Type to Range Area on one data source and choose the second under Target to shade between two values, such as an upper and a lower boundary.
Give values with different units their own value scale
Use this when one scale would flatten a value or mix units, such as a level in percent and a flow in kilograms per second.
- Under Scales > Value Scales, set Scale Type to Multiple (1). Each data source then gets its own scale in the color of its trace.
- Under Trace Options, select a data source and expand Axis Y.
- Set Position (1) to RIGHT to move the scale to the other side.
- Set Scale Range (2) to CUSTOM and enter Minimum and Maximum (3), for example 0 and 60.


The tank level uses the left scale from 0 to 100 percent and the feed rate uses the right scale from 0 to 60 kg/s.

Use Single for values with the same unit. Separate draws one plot per data source on a shared time axis. Custom lets you add named scales with + Add Scale and assign several related data sources to each one with the Axis Y list of a trace. A Single or Custom scale also offers Stacking.
Show equipment states next to a measurement
Use this to see which state the equipment was in while a value changed. The data source must be digital, enumeration or Boolean, such as a motor status.
- Drag the state data source onto the chart.
- Under Trace Options, select it (1).
- Set State display (2) to TREND or BANDS.
- For TREND, set Scale Type to Multiple or Separate under Scales > Value Scales, so the states get their own scale with state names.

TREND draws the state as a stepped line against named ticks. On a Single scale it plots the numeric state codes instead.

BANDS shades each state over the plot, with a label at its start and a legend entry per state.

State colors and names come from the data source's states. With Enable Multi-State on, you can change the colors under States; see Mark limits and color a value by range.
Zoom and pan into a period
Use this to look at part of a long range, for example the hour a motor ran.
- Hover the chart to show the toolbar. A new chart has Show Toolbar on under Trend Options > Toolbar.
- Select Box zoom (2) and drag across the period.
- Or select Zoom In (3) to halve the visible time, and Zoom Out (4) to double it.
- Select Pan (1) and drag the plot to move the window.
- Select Reset Zoom (5) to return.

The chart shows the dragged period, here 9:30 AM to 11:30 AM.

With Apply to Display Time on, which a new chart has, the zoom also sets the display time range, so every symbol that follows the display shows the same period. Reset Zoom restores the range the display had before. Turn Apply to Display Time off under Interactivity to zoom only this chart. The mouse wheel zooms too.
Read statistics for an interval
Use this to compare the average, minimum and maximum of each trace over a period you choose.
- Under Summary Table, turn Show on (1) and Start Expanded on (2).
- Turn on the columns you need, for example Standard deviation (3).
- Click the plot to place ruler A and click again for ruler B. Rulers are on for a new chart under Interactivity > Synchronize > Ruler.

The table adds the columns A, B and B - A and shows the average, minimum and maximum between the rulers. Without rulers it covers the display time range.

In this example the motor ran at an average of about 641 rpm between the rulers. The table uses server values for the interval, so they can differ from the boxes at the rulers, which use the points the chart has loaded.
Mark limits and color a value by range
Use this to see at a glance when a value is low, normal or high.
- Right-click the chart and select Add Multi-State....
- Select the data source in the list and check Enable Multi-State (1).
- Under Options, turn Color series (2), Lines (3) and Bands (4) on.
- Under States, set the upper limit of each range (5) and choose its color. Values below the lowest limit are bad data.

The trace changes color with the range it is in. Dashed lines mark the limits and shaded bands mark the ranges. Here the level is amber below 35 percent, green up to 60 percent and red above.

Use the symbol

| What it shows | |
|---|---|
| (1) | The toolbar. Its buttons depend on the settings; hover a button to see its name. |
| (2) | The legend with the latest value of each trace. Click an entry to hide or show its trace. This lasts for the session. |
| (3) | A state band with its label. |
| (4) | The hover tooltip with every value at the pointer time. |
| (5) | The summary table. |
Interactions
- Hover the plot to read every value at the pointer time. Lines and areas interpolate between points, steps and bars hold the previous value, and a scatter trace needs a point at that time. A gap in the data stays a gap.
- Click the plot to place ruler A, then ruler B. Drag a ruler's handle to move it, or select Clear rulers. With both rulers placed, the plot outside them is shaded, and an A-B arrow at the plot edge points to rulers outside the visible range. Hover and rulers are shared with other time-series charts on the display.
- Zoom with the mouse wheel or the toolbar. With Apply to Display Time on, drag the plot past its start or end in Pan mode and the display time range follows. The newly exposed part loads when you release.
- Click an event frame label to open its details. What you can do there depends on your permissions.
- Select Fullscreen to open the chart in a larger dialog, and Download to save it as PNG, SVG, PDF, CSV, JSON or XLSX. The data files hold the loaded samples with timestamp, value, unit and status. Fullscreen and downloads leave out the summary table.
| Button | What it does |
|---|---|
| Pan, Box zoom | Choose what a drag does: move the window, or zoom into the dragged period. |
| Select | Drag a band to choose the summary table interval without zooming. Available when the summary table is on. |
| Zoom In, Zoom Out, Reset Zoom | Halve the visible time, double it, or return to the full range. |
| Toggle Summary | Opens or collapses the summary table. |
| Create Event Frame | Opens the form to create an event frame for the dragged interval. Available when creation is on. |
Nothing in the chart writes data, except Save in the event frame form, which creates an event frame in AF. While creation is on, dragging draws the creation band and the zoom buttons are not available.
Configure the symbol
The pane has the sections Trend Options, Scales, Data Retrieval, Time Bar, Interactivity, Summary Table, Trace Options, Data Quality, Events and Export Data. Multi-state settings open from the context menu.
Trend Options
| Setting | What it does |
|---|---|
| Title, Sub Title | Show a title and subtitle. |
| Style | Theme, Surface, Container Style, Apply to all symbols and Font Size. Sparkline hides axes, grid and titles for a compact trend. |
| Legend | Enabled, Position (top, right, bottom or left), Placement (OUTSIDE reserves space, INSIDE overlays the plot), Alignment, Text (Name, Value or Name + Value), Value placement, Size (left and right legends) and Color (MARKER or TEXT). A new chart has the legend outside on the right. |
| Tooltip | Show turns hover values on. Pointer is NONE, ARGUMENT or CROSS. |
| Data Labels | Common label look: Show, Position, Name, Value, Background, Font Size and Time. Turn labels on per trace under Trace Options. Dense labels slow rendering. |
| Grid | Show, Lines (None, Horizontal, Vertical, Both), Bands and Border (AXES, FRAME, NONE). |
| Toolbar | Show Toolbar and Reveal (ON HOVER or ALWAYS). A new chart shows the toolbar on hover. The summary toggle and the creation buttons stay available when their features are on. |
| Bar | Width of each bar as a share of its time slot, 10 to 100 percent. Available when a trace is a bar. |
| Total | Show, Background, Units and Font Size of the stack total: a label on each stacked bar, or at the end of a stacked area or line, and a Total row in the tooltip. Available with Stacking set to Normal or Net. |
Scales
| Setting | What it does |
|---|---|
| Label Position | Draws the value labels Inside or Outside the plot. Inside, only the first scale on a side shows all labels, and Custom scales show no title. |
| Scale Type | Single, Multiple (the default for a new chart), Separate or Custom. See Give values with different units their own value scale. |
| Align Ticks | Lines up the ticks of the scales. Available with Multiple. |
| Stacking | In Single and in each Custom scale: OFF, Normal (add the contributions, negative values below zero), Net (negative values subtract from the stack) or 100% (each contribution as a share of the total). Stack bars only (default off) stacks only bars. A bar with a Stack Group stacks with that group. Scatter, range areas, states and annotations never stack. |
| Scale Range | Auto, Database or Custom. With Custom, Minimum and Maximum each have an Auto box. |
| Show, Position, Invert Scale, Transform, Title, Ticks, Units | Per scale: visibility, side, direction, Linear or Logarithmic, title and tick count. Units of a Single scale is shown as its title when Title is on and has no text. |
| Time Scale | Type (TIMELINE or DISCRETE), Labels (SCALE or RANGE: start, duration and end), Show, Position, Title, Fit Data and Datetime Format. Discrete gives each category its own position. |
State scales show every defined state at an evenly spaced tick and hide range, logarithmic and tick controls.
Data Retrieval and Time Bar
| Setting | What it does |
|---|---|
| Mode | Default: a reduced set of points for the chart width. Summary: one result per interval. Recorded: every archived value without compression, so limit the range for dense sources. Interpolated: values at regular times. |
| Interval, Sync Time | Interval and optional start of the interval grid. Available for Interpolated and Summary. |
| Type, Basis | The summary calculation (Total, Average, Minimum, Maximum, Range, Standard Deviation, Population StdDev, Count, Percent Good) and Time Weighted or Event Weighted. Available for Summary. A digital trend is not drawn with Summary. |
| Data Flags | Shows markers for questionable and substituted values. Available for Recorded. |
| Start- and Endtimes | Display time range, Custom time range or Duration and offset. A custom range keeps its own window when the display time changes. |
| Time Bar > Enabled | Adds the shared Time Bar with its own range controls. |
Interactivity
| Setting | What it does |
|---|---|
| Enable Zoom | Turns on wheel zoom and the drag and zoom buttons. On by default. |
| Drag mode | The starting mode: PAN or BOX ZOOM. The toolbar choice is temporary. |
| Apply to Display Time | Zoom and pan set the display time range and can move past the loaded range. On for a new chart. See Zoom and pan into a period. |
| Synchronize > Hover, Ruler | Share the hover position and the rulers with other time-series charts. With Ruler on, XY Plot+ highlights the points between the rulers. On for a new chart. |
Summary Table
| Setting | What it does |
|---|---|
| Show, Start Expanded, Height % (0 = automatic) | Turn the table on, open it at start, and set its height as a share of the chart, 0 to 60. |
| Identity and actions | Description, Show (a checkbox that hides a trace for the session), Regression, Moving Average and Multistate (checkboxes that change the trace's settings). Name is always shown. |
| Statistics | End Value, Average, Standard deviation, Min, Time at Min, Max, Time at Max, Event count and Range. A new table shows End Value, Average, Min and Max. |
| Boundaries and differences | Start Value, Start Time, End Value, End Time, Value difference and Duration. |
The statistics are server values, weighted by time. The table range is the interval between the rulers, otherwise a Select interval, otherwise the symbol time range. See Read statistics for an interval.
Trace Options
Select a data source in the list. The arrow buttons reorder it and the delete button removes it from the chart.
| Setting | What it does |
|---|---|
| Label, Hidden, Format, Units | Name, whether the trace starts hidden, number format, and whether values show their unit. |
| Display unit | Shows an AF attribute in another unit of the same kind. Default follows the unit in AF and converts nothing. A PI Point cannot be converted. Values you type, such as a scale range, are read in the displayed unit and are not converted. |
| Type | Line, Area, Bar, Scatter or Range Area. See Show values as lines, areas and bars. With Range Area, Target chooses the second data source. |
| Appearance | Color, Line Shape (STRAIGHT, STEPPED or SMOOTH, following the source's step setting at first), Line Style, Line Width, Marker, Marker Size and Opacity (%). |
| Analysis | Regression adds a dashed best-fit line. Moving Average adds a dotted average of the last Samples loaded values, 1 to 100. Not available for Range Area. |
| Axis Y | Scale settings per source. In Custom, a list assigns the source to a scale. |
| Data Labels, Legend | Labels and legend entry of this trace. Tooltip names the trace in the tooltip. |
| State display | TREND or BANDS for a digital, enumeration or Boolean source. Bands has Region, Opacity (%), Lines, Labels and States in legend. Not available for numeric settings such as stacking or regression. |
| Stack Group | Names the stack a bar belongs to. Available for stacked bars. |
A string source shows time markers with text labels.
Multi-state
| Setting | What it does |
|---|---|
| Enable Multi-State | Turns on state ranges for the selected data source. |
| Color series | Colors the line, markers, columns or area by state. Color data labels colors the labels. |
| Lines, Line color, Bands, Labels | Dashed lines at the limits (colored by STATE or SERIES), shaded ranges, and labels for them. |
| States | The upper limit and color of each range, a color for bad data, and Add for another range. |
Data Quality, Events and Export Data
| Setting | What it does |
|---|---|
| Hide No Data | Omits data sources without data from the chart, the legend and the summary table. See Data Quality. |
| Events > Display | Enabled shows event frames over the trend. Then right-click the chart and select Events Search Criteria... to choose which ones. Start, End, Color Mode (Severity or Auto), Line, Dash, Labels, Background, Style (Icon or Name), Position X, Position Y and Orientation style them. |
| Events > Creation | Enabled (needs Display on) adds creation buttons. Choose the assets (On Display, Current symbol or Related) and the template under Buttons. Drag an interval, select Create Event Frame, review the form and select Save. |
| Export Data | File Format (CSV, JSON, XLSX, PDF) and Download of the loaded data. |
Troubleshooting and limitations
See Troubleshoot chart data loading for the PI Vision log and what to send to support.
| Symptom | Cause | What to do |
|---|---|---|
| A trace is missing. | Hidden is on, you clicked its legend entry or cleared its Show box, Hide No Data removed it, or it is the second source of a range area. | Check these settings in that order. |
| A fast signal looks like a solid band. | Default or Recorded draws many points. | Use Interpolated or Summary with a larger interval. |
| Bars are crowded or thin. | The interval is short compared with the range. | Use a larger interval, or shorten the range. |
| A value scale starts above zero. | Lines and unstacked areas scale to their data. | Set Scale Range to Custom with Minimum 0. |
| A state trend shows numbers, not names. | Scale Type is Single, which plots the state codes. | Use Multiple or Separate, or choose BANDS. |
| Table values differ from the boxes at the rulers. | The table uses server values, the boxes use loaded points. | Read statistics from the table. |
| Zooming changes other symbols. | Apply to Display Time is on. | Turn it off under Interactivity. |
- Limitation: Fullscreen and downloads do not include the summary table.
- Limitation: Statistics and event counts are server values. Missing values are left empty; the table does not calculate them from the chart.
- Limitation: A digital trend is not drawn with Summary retrieval.
- Limitation: Moving past the loaded range is not available with Apply to Display Time off, on a DISCRETE time scale, with Fit Data, with a custom time range, or while event frame creation is on.
