Sankey+

Overview

Sankey+ shows the magnitude and direction of flows between configured nodes. Use it to visualize material, energy, utility, or cost flows through a process.

When to use it

Use Sankey+ when you need to:

• Show how a total is distributed between process stages.
• Compare the relative magnitude of several flows.
• Combine live process values with fixed reference flows.
• Identify where material, energy, or cost is gained or lost.

Use a standard process graphic when connectivity matters but flow magnitude does not.

Before you begin

• Identify every node in the flow network.
• Prepare one numeric data source for each live flow.
• Decide the start and end node for every flow.
• Remove cycles from the planned network; cyclical flows are not supported.

Add and set up the symbol

1. Select Sankey Plus in the PI Vision symbol gallery.
2. Drag the numeric flow data sources onto the display.
3. Open the configuration pane and create the required nodes.
4. Assign a start node and end node to each data source.
5. Add fixed flows when part of the diagram should use a constant value.
6. Confirm that every flow appears in the expected direction.

Use the symbol

Read flow width as relative magnitude and follow each band from its start node to its end node. Use the configured node and flow labels to identify names, values, units, and direction.

Configure the symbol

Nodes and flows

Nodes represent process stages. Flows connect those stages, and their widths are based on the associated value.

Individual nodes

• Name: Sets the displayed node name.
• Color: Sets the node color.
• Label: Shows or hides the node name and value.
• Height: Sets an individual label height when node-label height is Custom.
• Node position: Moves the node when the general position mode is Custom.

Node layout

• Position: Uses automatic placement or allows individual X and Y positions.
• Width: Sets the width of every node.
• Distance: Sets the spacing between nodes.

Live flows

• Label: Sets the displayed flow name.
• Value type: Uses the current value or a supported summary such as average, minimum, or maximum.
• Start: Selects the source node.
• End: Selects the destination node.
• Show label: Shows or hides the flow label.

Limitation: Sankey+ does not support cyclical flows. When a cycle is detected, the affected flow is not displayed and the symbol reports an error.

Static flows

• Name: Sets the fixed flow name.
• Value: Sets its constant magnitude.
• Color: Sets the flow color.
• Start and end: Select the connected nodes.
• Label: Shows or hides the static-flow label.

Node labels

• Show: Shows or hides all node labels.
• Name / Value: Selects the fields displayed in a label.
• Units: Selects a unit available from the configured data sources.
• Color: Uses one custom color or the associated node color.
• Opacity: Sets label opacity.
• Position: Places the label to the right, left, bottom, top, or inside the node.
• Height: Uses automatic height or an individually configured custom height.

Flow labels

• Show: Shows or hides all flow labels.
• Direction: Adds an arrow showing flow direction.
• Name / Value: Selects the fields displayed in a label.
• Color: Sets the label background color.
• Opacity: Sets the label background opacity.

Troubleshooting and limitations

• A flow is missing: Confirm its start and end nodes and check whether it creates a cycle.
• Flow widths are unexpected: Verify the selected value type and the units of the associated data sources.
• Nodes overlap: Increase node distance or switch to custom positioning.
• Labels overlap: Change label positions, reduce displayed fields, or increase the symbol size.