Waterfall Chart+
Waterfall Chart+ shows how a start value changes through a series of gains and losses until it reaches a final result. Each data source is one bar: either a total that stands on the baseline, or a step that rises or falls from the running total.
Overview

Watch the demo
See Waterfall Chart+ in a practical PI Vision workflow.
When to use it
Use Waterfall Chart+ when you need to:
- Show how losses take a start value down to a result, such as an OEE loss balance.
- Explain an energy, material, cost or production balance from start to end.
- Mark checkpoints in the balance, such as a subtotal after each group of losses.
Choose Combo Chart+ when the values are independent of each other, or when you must follow them over time. A waterfall only makes sense when the bars form one sequence.
Before you begin
- Prepare one numeric PI Point or AF attribute for each bar. Waterfall Chart+ does not calculate: the steps and the totals must exist as values in the PI System, for example as AF analysis outputs.
- Store a loss as a negative number and a gain as a positive number. If a source delivers a loss as a positive number, you can flip it later (see Flip a step that points the wrong way).
- Keep the data sources in the order the bars should appear. The first data source is always the start of the balance and is drawn as a total.
- Use values that share one unit. The chart adds and compares them as they are.
Add and set up the symbol
- Select Waterfall Chart+ in the PI Vision symbol gallery.
- Drag the data sources onto the display in the order of the balance: the start value first, then each step, with a subtotal or the end result where you want a checkpoint.
- Right-click the symbol and select Configure Waterfall Chart.
- Under Trace Options, select each data source that is a checkpoint and set Total to ON.
- Close the pane. The symbol shows the start and each checkpoint as a full bar from the baseline, and every other bar as a step that falls or rises from the running total.

Common tasks
Mark the start, subtotals and end as totals
Use this when a bar must show its own value from the baseline instead of a change, for example the value after each group of losses.
- Right-click the symbol and select Configure Waterfall Chart.
- Under Trace Options, select the data source in the list (1).
- Set Total (2) to ON.
- Repeat for every data source that should be a total.

The bar is drawn from the baseline up to its own value and the running total continues from it. A total does not add up the steps before it: if the data does not agree, the chart shows the gap.
If you leave Total off for a checkpoint, the chart treats its value as one more step. In the next image, Operating Time is a step, so its 84.5 % rises from the running total and the later bars float high above the baseline.

Flip a step that points the wrong way
Use this when a source delivers a loss as a positive number, or a gain as a negative number. The chart draws a negative value as a step down and a positive value as a step up.
- Under Trace Options, select the data source in the list (1).
- Make sure Total is OFF. Invert is not available for a total.
- Set Invert (2) to ON.

The chart multiplies the value by -1, so the bar and its label change direction. In this example the source already reports a loss as a negative number, so Invert turns the -10 % loss into a +10 % gain. Switch it on only when the sign in the data is wrong.

Color increases, decreases and totals
Use this when the default colors clash with your display or your plant standard.
- Right-click the symbol and select Configure Waterfall Chart.
- Open Coloring. Make sure Mode is Default.
- Select the color for Total (1), Positive (2) and Negative (3).

Total bars, increases and decreases take their own color, and the data labels follow the bar color.

To give single bars their own color, set Mode to Custom. Then select each data source under Trace Options and choose its Color.
Label the bars with their values
Use this when readers should see each value without hovering, or when thin steps need a readable label.
- Open Data Labels. Make sure Show is ON.
- In Position (1), select where the label sits: Auto, Outside, Inside, Inside Bottom or Inside Top.
- Set Background (2) to ON to put a badge in the bar color behind each label.
- Set Units (3) to ON to print the unit after the value, or to OFF to show the bare number.

Every bar shows its value. A step shows its signed change, and a total shows its own value. Inside centers the label in the bar, which keeps the label of a thin step readable.

Name adds the data source name to each label. The name already appears on the axis, and on a narrow vertical chart the labels overlap, so leave Name off unless the chart is wide.
Zoom the value scale on the losses
Use this when the losses are small next to the total and you want to compare them. Total bars start at the lowest value of the scale, so a zoomed chart no longer shows the totals from zero.
- Open Value Scales.
- Under Value Scale, set Scale Range (1) to Custom.
- Enter the lowest value in Minimum (2) and the highest value in Maximum (3).

The scale shows only the chosen range and the steps get taller. Choose Auto to let the chart fit the scale to the values again.

Read the balance from top to bottom
Use this when the category names are long, or the symbol is tall and narrow.
- Open Common.
- Under Orientation (1), select Horizontal.
- Open Value Scales. Under Axis X, set Invert Scale to ON.

The bars run from left to right and the names sit on the left. Without Invert Scale, the first data source is at the bottom. With it, the balance reads from the top down.

Use the symbol

| What it shows | |
|---|---|
| (1) | The title, if it is switched on. |
| (2) | A total bar: a value measured from the baseline. |
| (3) | A step bar. It starts at the running total and ends where the balance moves to. Its color shows an increase or a decrease. |
| (4) | A data label with the value, or for a step the signed change. |
| (5) | The data source name of the bar. |
| (6) | The tooltip: the name, the Change of a step and the Total the balance reaches at that bar. |
- Read left to right (or top to bottom on a horizontal chart). Each step starts where the previous bar ended.
- Hover a bar to see its tooltip.
- A step with no good value draws as 0.
- Display time: the chart follows the PI Vision display time. In a live display the bars update with new values. To show an average or another statistic over the range, see Value Type in Trace Options.
- The symbol only displays data. It does not write to the PI System or change other symbols.
Configure the symbol
Right-click the symbol and select Configure Waterfall Chart.
Common
| Setting | What it does |
|---|---|
| Title, Sub Title | Show or hide each heading and set its text. |
| Font Size, Alignment | Set the heading text size and its position: left, center or right. |
| Orientation | Vertical draws columns, Horizontal draws bars. Used in Read the balance from top to bottom. |
Style
| Setting | What it does |
|---|---|
| Theme | Selects the color theme, from Software Athlete to Custom Theme. Custom Theme adds Foreground and Background colors. |
| Surface | Selects Flat or Gradient fill. |
| Container Style | Selects the frame around the symbol: None, Flat, Card, Framed or Glass. |
| Apply to all symbols | Copies the theme, surface, container style and display background to every other Vision Library+ symbol on the display. |
| Font Size | Sets the size of the chart text. |
Grid
| Setting | What it does |
|---|---|
| Show | Turns the grid on or off. |
| Lines | Draws None, Horizontal, Vertical or Both grid lines. The names follow the direction the lines run on screen. |
| Bands | Draws alternating shaded bands across the plot area. |
| Border | Axes draws the two axis lines, Frame draws a rectangle around the plot, None draws neither. |
Bars
| Setting | What it does |
|---|---|
| Width | Sets how much of its slot each bar fills. |
| Border Radius | Rounds the bar corners. |
Coloring
| Setting | What it does |
|---|---|
| Mode | Default uses one color each for totals, increases and decreases. Custom uses the Color of each data source. Used in Color increases, decreases and totals. |
| Total, Positive, Negative | Set the three colors. Available when Mode is Default. |
Data Labels
| Setting | What it does |
|---|---|
| Show | Shows or hides the labels. |
| Position | Places the label Auto, Outside, Inside, Inside Bottom or Inside Top. Used in Label the bars with their values. |
| Name, Value | Choose whether a label shows the data source name, the value, or both. |
| Background | Puts a badge behind each label. |
| Font Size | Sets the label text size. |
| Units | Prints the unit after the value. |
Tooltip
| Setting | What it does |
|---|---|
| Show | Turns the hover tooltip on or off. |
| Pointer | None shows only the tooltip, Argument also highlights the bar under the pointer, Cross adds a line and readout on the value scale. |
Value Scales
| Setting | What it does |
|---|---|
| Label Position | Two picture buttons that place the scale labels outside or inside the plot area. |
| Show, Position | Show or hide the value scale and choose its side: Left or Right. |
| Invert Scale | Reverses the direction of the value scale. |
| Scale Range | Auto fits the scale to the values. Database takes the range from the zero and span of the AF attribute. Custom adds Minimum and Maximum, each with an Auto check box. Used in Zoom the value scale on the losses. |
| Title, Ticks | Show a scale title. Ticks is Auto or Custom. |
| Axis X | The same controls for the axis that carries the bar names: Show, Position (Bottom or Top), Invert Scale and Title. |
The value scale is always linear.
Trace Options
| Setting | What it does |
|---|---|
| Data source list | Lists the bars in the order they are drawn. Use the buttons below the list to move or remove a data source. |
| Value Type | Value uses the value at the display time. Average, Maximum, Minimum, StdDev, pStdDev and Range use that statistic over the display time range. |
| Color | Sets the bar color. Available when Coloring Mode is Custom. |
| Total | Draws the bar as a total from the baseline. The first data source is always a total. Used in Mark the start, subtotals and end as totals. |
| Invert | Multiplies the value by -1. Available when Total is OFF. Used in Flip a step that points the wrong way. |
| Label | Selects the name shown for the bar, or lets you enter a custom name. |
Numbers
| Setting | What it does |
|---|---|
| Number format | Sets the format of the values in labels and the tooltip. |
Troubleshooting and limitations
| Symptom | Cause | What to do |
|---|---|---|
| A checkpoint bar floats above the baseline. | Total is off for that data source, so the chart treats it as a step. | Set Total to ON for the data source. |
| A loss rises instead of falling. | The source reports the loss as a positive number. | Set Invert to ON for that data source. |
| A bar that should fall rises after you turned Invert on. | The source already reports the loss as a negative number. | Set Invert to OFF. |
| A total does not match the running total above it. | A total shows its own value and does not add up the steps. | Check the values in the PI System: the total and the steps do not agree. |
| A step is missing or drawn as 0. | The data source has no good value at the display time. | Check the data source in Trace Options and the display time. |
| The labels overlap. | Name is on, or the symbol is too small for nine or more bars. | Set Name to OFF, enlarge the symbol or choose Horizontal. |
| The totals look short next to the steps. | A custom scale range starts above zero. | Set Scale Range to Auto. |
Limitation: Waterfall Chart+ shows the values it receives. It does not calculate differences, sums or percentages.
Limitation: The value scale is linear. A logarithmic scale is not offered.
Limitation: The bars follow the order of the data sources. The chart does not sort them.
