Sankey Chart Properties
The property panel contains all configuration settings for your Vizlib Sankey Chart, organized into dimensions, measures, sorting, data handling, appearance, interactivity, and viztips sections.
This topic contains the following sections:
Dimensions, Measures, Sorting, Data Handling
Vizlib Sankey Chart supports one measure with multiple dimensions. In the Data section, you can add dimensions or metrics dynamically and decide whether they should be used directly or added as alternative dimensions, which can be selected when you're in analysis mode.
Dimensions
When you add a dimension, you can choose to Include null values, and set a Limitation on your chart data, choosing from a Fixed number (e.g. the top 10 values), the Exact value, or a Relative value (e.g. only showing values above 50%). Show (Always / Conditional) gives you the ability to specify a conditional expression which shows or hides the dimension in the Sankey chart. Node Color specifies a color for the dimension, and you can also specify the color using a HEX code in a Qlik expression. You can also display the dimension label by enabling Node Label and display the measure value for the dimension nodes with Node Value.
Figure 1: Dimensions
Group Nodes enables grouping to join multiple dimension values into groups.
Figure 2: Group Nodes
Measures
When you add a measure, there's a setting to enable Master measure formatting, which means formatting for the measure will be taken from the master item definition (you can find master items in the Custom Objects menu in the left hand panel). You can also choose to Use custom Pattern, select a Number formatting option, and enable Use currency to add currency formatting.
Note: Master measure formatting is not displayed for measures created using the Fields list.
Figure 3: Measures
Sorting
The Sorting settings allows you to enable a General sort by node size, and set it in Ascending or Descending order.
Figure 4: Sorting
Data Handling
With Data Handling settings, you can set a Sankey Nodes Limit specifying the Max Nodes Per One Dimension, and set a Data Downloading limit (by default, this is limited to the first 5000 rows). You can also choose to Suppress Zero Values and set a Calculation Condition to display the chart if a condition is met.
Figure 5: Data Handling
Appearance
The Appearance settings control the look and feel of your Vizlib Sankey Chart.
General
In the General tab, you can choose to show or hide a Title, Subtitle and Footnote and Show or Hide details.
Figure 6: General
Links Styling
Links Styling contains settings for styling the links in the sankey chart. With Link colors, there are options to choose a solid or blend-in Color mode (inheriting the colors of connecting nodes and blending them together), and set the Link Opacity. With Link value Labels you can choose to display a label, set the Link Label Font Color, Links Label Font Size, Links Label Font Style and Links Label Position.
Figure 7: Links Styling
Nodes Styling
Nodes Styling allows you to apply styling to the nodes in the sankey chart, setting the Nodes Width and Distance between nodes in Nodes Styling.
Figure 8: Nodes Styling
With Labels you can set the Node Label Orientation, Node Label Font Color and Node Label Font Size, choose to display the Label inside the node and Prevent Labels overlapping. You can also choose to enable a Node Label Length Limit.
Figure 9: Labels
With Values you can set the Node Value Orientation, Node Value Font Color, Node Value Font Size, Node Value Font Style and set the Value inside the node.
Figure 10: Values
Colors
There are two options for applying Colors to the sankey chart. With Color by Node you can choose a Coloring Type (Classes color each node distinctly, gradient colors the node based on measure value and sequential colors the nodes on a pre-defined range). You can also choose to Use Custom Colors and enter HEX color codes, and also choose to Reverse Colors and invert the color scheme.
Figure 11: Color by Node
When you choose Color by Dimension, you can choose to Use Color Scheme or enter a custom list using HEX color codes, and select Reverse Colors to invert the color scheme.
Figure 12: Color by Dimension
Dimension Titles
When you choose to enable Dimension Titles, you can set the Position, choose a Font Color, Font Size, Font Style and set a Background Color and Background opacity, you can also choose to enable Show alternative count and Show drilldown breadcrumbs.
Figure 13: Dimension Titles
Measure Title
When you enable Measure Title, you can set the measure Position, and choose the Font Color, Font Size, Font Style, a Background Color, Background Opacity, and enable Show alternative count.
Figure 14: Measure Title
Font Settings
Font Settings allow you to choose a Font Family for the sankey chart.
Figure 15: Font Settings
Interactivity and Alternate State
The Interactivity settings control how the user interacts with your Vizlib Sankey Chart.
Interactivity
You can Allow Selections within the chart (without this, the chart will be read-only) and Enable Multiselect to allow more than one selection at a time. If you enable Highlight, you can select an option to define how highlighting will work within the chart.
Figure 16: Interactivity
You can also enable Zooming within the chart, while Dragging gives you the ability to vertically drag nodes within the Sankey chart. You can also enable Animations in the chart and set the Animation speed. The Show Restore Chart Icon will return you to the original view of the Sankey Chart after zooming in and Show Maximise Icon will allow users to maximize objects.
Figure 17: Interactivity
Alternate State
Alternate State allows you to assign the Vizlib Sankey Chart to an alternate selection state. You can find more on alternate states here.
Figure 18: Alternate State
Viztips and Tooltips
The Viztips and Tooltips settings help you to manage tooltips in Vizlib Sankey Chart, and you can also enable Viztips to add dynamic tooltips. If you'd like to find out more about Viztips, you can find our overview article here.
Viztips and Tooltips
To display Tooltips, you need to move the slider to Enabled, and then you can select the Viztips option to start working with dynamic tooltips. There's also a link to the Viztips tutorial if you need to check anything.
Figure 19: Viztips and Tooltips
Viztips Content
Viztips Content settings contain a drop-down where you select the master item, and includes a copy function for Viztips placeholder tags and a further link to the tutorial.
Figure 20: Viztips Content
Viztips Settings
With Viztips Settings, you can use the sliders to change the height and width of the Viztips object in the chart.
Figure 21: Viztips Settings