Sankey chart extension

The Sankey chart (Sankey chart) is a visualization extension that lets you add a specific type of flow chart to the sheet you are editing. The chart visually emphasizes major transfers or flows within defined system boundaries. The width of the chart arrows is shown proportionally to the flow quantity. The Sankey chart is included in the Visualization bundle.

  • A minimum of two dimensions and one measure is required.
  • The chart can measure up to five dimensions simultaneously.
  • The dimensions need not be of equal size on each side of the diagram.

  • The dimension values set the color of the flows in the chart.
  • Link colors are based on source or target anchor.

When to use it

The sankey chart diagram is useful when you want to locate most significant sections to an overall flow. The chart is also helpful when you want to show specific quantities maintained within set system boundaries.

Creating a sankey chart diagram

You can create a sankey chart on the sheet you are editing.

Do the following:

  1. In the assets panel, open Custom objects > Visualization bundle and drag a Sankey chart object to the sheet.
  2. Click the top Add dimension button and select the source dimension for the flow of the chart (appears to the left).
  3. Click the second Add dimension button to select the target dimension for the flow of the chart (appears to the right).
  4. Click the Add measure button to select the measure of the chart.

Once dimensions and measure have been selected the sankey chart diagram displays automatically (in color) in the chart field.

Example:

A chart with a source dimension (Quarter) and the target dimension (Year).

Adding additional dimensions

You can add up to five dimensions to your chart in property panel under Data > Dimensions. The chart updates to reflect the added dimensions. The dimensions are displayed from left to right, with the first entered dimension always being the source dimension. The target dimension is always displayed to the to the right. When you add more dimensions, they appear are added to the right in the order they are entered.

A chart with three dimensions: the source dimension (Origin), the target dimension (Decision) and one additional (Destination).

Changing the appearance of the chart

You can customize your chart with one or more features. Your chart automatically updates.

Link colors

The colors of chart links are based on either the source or target anchors. To apply the source or target anchor color to chart links either use the string ='SOURCE' or ='TARGET'. You can also select a separate color by entering a color code string. The color should be a valid CSScolor.

Do the following:

  1. Click Presentation under Appearance in the property panel.
  2. Enter the applicable string under Link color.
  3. Press Enter and the chart updates.

You can also change the link colors using an expression in the Expression editor (Expression). It is also possible to color a link that has its intensity based on the Margin % of the dimension values it represents.

Example:  

Enter the string =rgb(round(Avg ([Margin %])*255), 100, 100) where Margin % is a value between 0-1 and the link will display as red in the chart.

Link opacity

You can adjust link opacity by moving the slide button of the link opacity slider under Appearance > Link opacity in the property panel. Also, setting opacity to 1 (furthest right) allows the setting to drop a shadow, giving links a more individually distinct appearance.

Node colors

You can change the node colors of each dimension value. The color should be a valid CSScolor.

Do the following:

  1. Select applicable dimension under Data > Dimensions in the property panel.
  2. Enter the color code string under Node color and press Enter. The chart will update.

    Example:

    Color Aqua: #00ffff in string: ='#00ffff'

You can also set the node colors using an expression in the Expression editor (Expression).

    Region dimension values colored by an expression.

Node padding and width

You can set both the vertical distance between nodes ("node padding") and the horizontal width of chart nodes ("node width"):

    1. Click Presentation under Appearance in the property panel.
    2. Move applicable slide button of the Node padding and/or Node width sliders to adjust node settings.

Limitations

For information about general limitations, see Limitations of extension bundles supplied by Qlik.