Documentation Vision Library+ Documentation

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

Combo Chart+ with a motor speed trace, equipment state bands and a summary table

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

  1. Select Combo Chart+ in the PI Vision symbol gallery.
  2. 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.
  3. Right-click the chart and select Configure Combo Chart....
  4. Under Data Retrieval, set Mode to Interpolated and Interval to 20 Minute. This gives one value per interval, which keeps a fast signal readable.
  5. Under Trace Options, select each data source in the list and enter a Label.
  6. Close the pane. The chart shows one trace per data source, each on its own value scale, and the legend shows the latest values.
Combo Chart+ with a tank level in percent and a feed rate in kilograms per second

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.

  1. Right-click the chart, select Configure Combo Chart... and scroll to Trace Options.
  2. Select the data source in the list (1).
  3. 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.
  4. Under Data Retrieval, keep Mode on Interpolated, or choose Summary and an Interval. Neighboring bars then cover equal intervals.
Trace Options with the data source list and Type marked

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

A tank level area and feed rate columns

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.

  1. Under Scales > Value Scales, set Scale Type to Multiple (1). Each data source then gets its own scale in the color of its trace.
  2. Under Trace Options, select a data source and expand Axis Y.
  3. Set Position (1) to RIGHT to move the scale to the other side.
  4. Set Scale Range (2) to CUSTOM and enter Minimum and Maximum (3), for example 0 and 60.
Value Scales group with Multiple marked
Axis Y group with Position, Scale Range and Minimum marked

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.

Two traces with a blue scale on the left and an orange scale on the right

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.

  1. Drag the state data source onto the chart.
  2. Under Trace Options, select it (1).
  3. Set State display (2) to TREND or BANDS.
  4. For TREND, set Scale Type to Multiple or Separate under Scales > Value Scales, so the states get their own scale with state names.
Trace Options for the motor state with State display marked

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

Motor speed and a motor state trend with named ticks on the right

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

Motor speed with shaded state bands

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.

  1. Hover the chart to show the toolbar. A new chart has Show Toolbar on under Trend Options > Toolbar.
  2. Select Box zoom (2) and drag across the period.
  3. Or select Zoom In (3) to halve the visible time, and Zoom Out (4) to double it.
  4. Select Pan (1) and drag the plot to move the window.
  5. Select Reset Zoom (5) to return.
Toolbar with Pan, Box zoom, Zoom In, Zoom Out and Reset Zoom marked

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

Chart after Box zoom with Box zoom and Reset Zoom marked

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.

  1. Under Summary Table, turn Show on (1) and Start Expanded on (2).
  2. Turn on the columns you need, for example Standard deviation (3).
  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.
Summary Table group with Show, Start Expanded and Standard deviation marked

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.

Rulers A (1) and B (2) around a running period, the plot shaded outside them, and the Average column (3) of the summary table

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.

  1. Right-click the chart and select Add Multi-State....
  2. Select the data source in the list and check Enable Multi-State (1).
  3. Under Options, turn Color series (2), Lines (3) and Bands (4) on.
  4. Under States, set the upper limit of each range (5) and choose its color. Values below the lowest limit are bad data.
Multi-state pane with the options and three limits

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.

A tank level trace colored by range with dashed limit lines

Use the symbol

Combo Chart+ with five numbered callouts
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.
ButtonWhat it does
Pan, Box zoomChoose what a drag does: move the window, or zoom into the dragged period.
SelectDrag a band to choose the summary table interval without zooming. Available when the summary table is on.
Zoom In, Zoom Out, Reset ZoomHalve the visible time, double it, or return to the full range.
Toggle SummaryOpens or collapses the summary table.
Create Event FrameOpens 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

SettingWhat it does
Title, Sub TitleShow a title and subtitle.
StyleTheme, Surface, Container Style, Apply to all symbols and Font Size. Sparkline hides axes, grid and titles for a compact trend.
LegendEnabled, 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.
TooltipShow turns hover values on. Pointer is NONE, ARGUMENT or CROSS.
Data LabelsCommon label look: Show, Position, Name, Value, Background, Font Size and Time. Turn labels on per trace under Trace Options. Dense labels slow rendering.
GridShow, Lines (None, Horizontal, Vertical, Both), Bands and Border (AXES, FRAME, NONE).
ToolbarShow 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.
BarWidth of each bar as a share of its time slot, 10 to 100 percent. Available when a trace is a bar.
TotalShow, 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

SettingWhat it does
Label PositionDraws 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 TypeSingle, Multiple (the default for a new chart), Separate or Custom. See Give values with different units their own value scale.
Align TicksLines up the ticks of the scales. Available with Multiple.
StackingIn 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 RangeAuto, Database or Custom. With Custom, Minimum and Maximum each have an Auto box.
Show, Position, Invert Scale, Transform, Title, Ticks, UnitsPer 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 ScaleType (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

SettingWhat it does
ModeDefault: 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 TimeInterval and optional start of the interval grid. Available for Interpolated and Summary.
Type, BasisThe 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 FlagsShows markers for questionable and substituted values. Available for Recorded.
Start- and EndtimesDisplay time range, Custom time range or Duration and offset. A custom range keeps its own window when the display time changes.
Time Bar > EnabledAdds the shared Time Bar with its own range controls.

Interactivity

SettingWhat it does
Enable ZoomTurns on wheel zoom and the drag and zoom buttons. On by default.
Drag modeThe starting mode: PAN or BOX ZOOM. The toolbar choice is temporary.
Apply to Display TimeZoom 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, RulerShare 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

SettingWhat 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 actionsDescription, 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.
StatisticsEnd 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 differencesStart 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.

SettingWhat it does
Label, Hidden, Format, UnitsName, whether the trace starts hidden, number format, and whether values show their unit.
Display unitShows 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.
TypeLine, Area, Bar, Scatter or Range Area. See Show values as lines, areas and bars. With Range Area, Target chooses the second data source.
AppearanceColor, Line Shape (STRAIGHT, STEPPED or SMOOTH, following the source's step setting at first), Line Style, Line Width, Marker, Marker Size and Opacity (%).
AnalysisRegression 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 YScale settings per source. In Custom, a list assigns the source to a scale.
Data Labels, LegendLabels and legend entry of this trace. Tooltip names the trace in the tooltip.
State displayTREND 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 GroupNames the stack a bar belongs to. Available for stacked bars.

A string source shows time markers with text labels.

Multi-state

SettingWhat it does
Enable Multi-StateTurns on state ranges for the selected data source.
Color seriesColors the line, markers, columns or area by state. Color data labels colors the labels.
Lines, Line color, Bands, LabelsDashed lines at the limits (colored by STATE or SERIES), shaded ranges, and labels for them.
StatesThe upper limit and color of each range, a color for bad data, and Add for another range.

Data Quality, Events and Export Data

SettingWhat it does
Hide No DataOmits data sources without data from the chart, the legend and the summary table. See Data Quality.
Events > DisplayEnabled 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 > CreationEnabled (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 DataFile 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.

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