Scatter Chart Properties
The property panel contains all configuration settings for your Vizlib Scatter Chart, organized into data, appearance, colors, bubble format, reference objects, and interactivity sections.
This topic contains the following sections:
Data and Data Handling
The Data menu contains settings for the Dimensions and Measures used in Vizlib Scatter Chart. You can find an example of how to use dimensions and measures to create a scatter chart in the setup article here.
Dimensions
Vizlib Scatter Chart supports up to two Dimensions.
Figure 1: Dimensions
Dimension 1 is required to display the visualization.
Dimension 2 can be added to display the historical tracking trails of a dimension over time, so it needs to be a timestamp.
Note: If you decide to add a second dimension, please ensure there are no gaps in time values, and the dimensions all have 100% data density.
The dimension settings allow you to edit the display Label, Include null values, and set a Limitation on the display values: a Fixed Number, an Exact Value, and a Relative Value.
Figure 2: Dimension Settings
You can also enable Markers for dimensions, to help visualize the data points on the scatter chart. You can choose between three types of Representation: a Symbol (select from a list), an Icon (select from a list of > 700 icons, or upload your own) and Image (add an image using a URL or the Qlik Sense content editor). You can also control the Symbol Size, and Symbol Opacity.
Figure 3: Dimension Markers
Measures
Vizlib Scatter Chart supports up to three Measures.
Figure 4: Measures
Measure 1 is mandatory and displayed along the x-axis.
Measure 2 is mandatory and displayed along the y-axis.
Measure 3 is optional and determines the bubble size.
The measure settings allow you to edit the display Expression, and control the Number formatting by selecting from a list of options and choosing between a Simple format or a Custom format (where you enter your own values). You can also choose to add a new Master item.
Figure 5: Measure Settings
Data Handling
Data Handling controls allow you to set Data Limits, Suppress Zero Values, and enter a Calculation condition to show a Displayed message when the calculation is met.
Figure 6: Data Handling
Appearance
The Appearance tab manages settings relating to the look and feel of your Vizlib Scatter Chart.
General
In the General tab, you can choose to show or hide a Title, add a Subtitle or Footnote using the expression editors and enable Show details to display details for chart values.
Figure 7: General
Dimension
In the Dimension settings, you can show the Dimension title, set the Dimension color, choose the Font Size, select a Font Family, and a Dimension Font Style. You can also enable alternative dimensions with Show Alternative Count and Show drilldown breadcrumbs.
Figure 8: Dimension
X-Axis
X-axis settings allow you to make changes to the way the x-axis in the scatter chart is displayed.
Figure 9: X-Axis
In the X-axis settings, you enable the axis display with Show/Hide, hide the axis label with Hide X-axis label, set the X-axis Color, set the X-axis Tick Font Size (the measurement scale the axis uses), and control axis line thickness with Axis Width.
The Label settings allow you to set the X-axis Label Font Size, choose a Font Family, a Font Style, and select Drop Shadow to apply a text shadow effect.
You can use X-axis Ticks to control the number of ticks the axis displays, choose between a linear or logarithmic Scale, control the tick values' numeric display with X-axis Tick Format and enable a Currency Format to set a currency symbol position.
X-axis range controls the calculation of the range for metrics values, either automatically or entering a minimum or maximum value.
You can also choose to Hide X-axis Tick Labels, enable min/max smoothing to ensure the axis begins and ends with an appropriate rounded integer value, and choose Display zero reference line to show a zero value. X-Axis Margin controls the scatter chart margin, increasing or decreasing the amount of empty space around the edges of the chart (margins are not available for a Min/Max X-axis range).
Y-Axis
Y-axis settings allow you to make changes to the way the y-axis in the scatter chart is displayed.
Figure 10: Y-axis
In the Y-axis settings, you enable the axis display with Show/Hide, hide the axis label with Hide Y-axis label, set the Y-axis Color, set the Y-axis Tick Font Size (the measurement scale the axis uses), and control axis line thickness with Y-axis Width.
The Label settings allow you to set the Y-axis Label Font Size, choose a Font Family, a Font Style, and select Drop Shadow to apply a text shadow effect.
You can use Y-axis Ticks to control the number of ticks the axis displays, choose between a linear or logarithmic Scale, control the tick values' numeric display with Y-axis Tick Format and enable a Currency Format to set a currency symbol position.
Y-axis range controls the calculation of the range for metrics values, either automatically or entering a minimum or maximum value.
You can also choose to Hide Y-axis Tick Labels, enable min/max smoothing to ensure the axis begins and ends with an appropriate rounded integer value, and choose Display zero reference line to show a zero value. Y-Axis Margin controls the scatter chart margin, increasing or decreasing the amount of empty space around the edges of the chart (margins are not available for a Min/Max Y-axis range).
Colors and Legend
Colors and Legend settings allow you to manage the colors used in your scatter chart and the legend used to explain the color classifications.
Legend
If you enable the Date Label Customization settings you'll be able to set the Date Label Font Style, the Date Label Font Size, choose the Date Label Font Family, set the Date Label Opacity level and choose the Date Label Color.
Figure 11: Date Label
If you choose to display a Bubble Legend, you can enter a format for Legend Values (comma separated), set the Legend position, enter a Legend Title, set the Legend Title Font Size, Legend Value Font Size and choose the Font Family.
Figure 12: Bubble Legend
If you enable Show Legend to display the legend, you can set the Legend Position, the Legend Font Color, the Font Size and customize a Char limit (character limit).
Figure 13: Show Legend
The following example shows a legend at the top of the chart, and a bubble legend in the bottom right of the chart.
Figure 14: Legend Example
Colors
You can choose the color for bubbles in the scatter chart by selecting the Bubble Color drop-down, with options to color by Dimension, Master Item, Cluster, Expression, Measure, App Theme and Custom Color.
Figure 15: Color
Figure 16: Bubble Color Options
Enabling the Inherit from Theme setting lets you apply a single color change across all your apps. You can also enable these color settings:
Reverse Colors to switch the allocated color scheme values (e.g. for coloring by measure, colors allocated to low values are re-allocated to high values).
Persistent Colors keeps the colors you choose between selection states, so you can select another drop-down option without losing any changes.
Figure 17: Inherit from Theme
Vizlib Scatter Chart can also inherit a color scheme created in Qlik Sense. If you'd like to learn more about coloring a visualization in Qlik Sense, click here.
Bubble Format, Grid Format
In addition to Cluster formatting, you can use the Bubble and Grid formats to analyze risk over time.
Hovering over a bubble displays its movement over time (its 'snail trail'). Create an interaction, on the legend to view the data per year, or to compare years.
The following example shows the Bubble and Grid formatting applied to a scatter chart.
Figure 18: Scatter Chart Bubbles
Grid Format
Grid Format settings allow you to Show a grid in your scatter chart and control its appearance. Use the toggle to use the Grid format.
Formatting options include setting its: Grid Style, Grid Color, Grid Opacity, and Grid Thickness.
Figure 19: Grid Format
Bubble Format
The Bubble Format settings help you to manage the appearance of the bubbles in your scatter chart.
Slide the toggle to Show Labels and set either limited or conditional formatting within the Labels visibility, options.
Other formatting options include: Avoid Label Overlapping, setting the Label Font Color, Label Font Size and Label Font Family.
Label Visibility
Limited (30) |
Conditional |
|---|---|
Labels on bubbles are visible only when there are 30 or fewer on a chart. |
A set condition that defines which labels are displayed (e.g. company name). |
|
Figure 20: Limited labels |
Figure 21: Conditional Labels |
Bubble Size, Border, and Colors
You can also set Bubble Size, its Bubble Border Width, and choose to customize a Border Color and Bubble Color by entering an expression, or setting the color to Inherit.
Figure 22: Bubble Size and Color
Reference Objects
When you're working with Vizlib Scatter Chart, you can add several types of reference object to indicate specific data points. You can choose reference lines (X-Axis and Y-Axis), reference bubbles, reference polygons, reference areas and also trend lines. You can find these settings in the property panel under Reference Objects.
Reference Lines
Reference lines are vertical or horizontal lines in a graph, and you can display them in your scatter chart by defining the values for X-Axis Reference Lines and Y-Axis Reference Lines.
X-Axis
X-Axis Reference Lines settings allow you to set the Value on X-Axis, add your own Label, and set the label Font Color, Font Size, Font Family and Font Style.
Figure 23: Value, Label, Font
You can add a shadow effect to the label with Drop Shadow, set the Label Position, and the Label Orientation. You can also set the Line Color, Line Width and Line Style, as well as choose to Show the line only when a calculation condition is met.
Figure 24: Label Position, Orientation, Line Style
Y-Axis Reference Line
Y-Axis Reference Lines settings allow you to set the Value on Y-Axis, add your own Label, and set the label Font Color, Font Size, Font Family and Font Style.
Figure 25: Y-Axis Reference Line
You can add a shadow effect to the label with Drop Shadow, set the Label Position, and the Label Orientation. You can also set the Line Color, Line Width and Line Style, as well as choose to Show the line only when a calculation condition is met.
Figure 26: Position, Orientation, Line Style
The following example shows a reference line on the X axis of a Scatter Chart.
Figure 27: Reference Line Example
Reference Bubbles
Adding a Reference Bubble displays a circle on a graph to highlight some data based on the axis values set by the user. You can add a Label, set an x axis Value, y axis Value, Bubble Size Value and Bubble Color. You can also display an Outer Bubble Line, set a level of Bubble Opacity, enable Bubble Tooltip and choose to Show the bubble only when a calculation condition is met.
Figure 28: Reference Bubble
The following example shows a reference bubble.
Figure 29: Reference Bubble Example
Reference Area
A Reference Area shades a specific area on the scatter chart based on the axis values set by the user. You can set a Label, enable an Auto Font Size, set the Label Font Size, the Label Position and choose the range of co-ordinates for the area display by entering x Value, x2 Value, y Value and y2 Value.
Figure 30: Reference Area Label
You can also set the Area Background, Area Color, show an Outer Area Line, set an Outer Color, choose the level of Area Opacity and choose to Show the area only when a calculation condition is met.
Figure 31: Reference Area Background
The following example shows a scatter chart divided into four separate reference areas, each one a different color.
Figure 32: Reference Area Example
Reference Polygon
A Reference Polygon creates a reference area by adding reference lines in a graph. The polygon can be of any shape and will be displayed as a shadow behind the bubbles. You can add a Label, set the Area Color and display an Outer Area Line, set the Line Width, Line Style, Area Opacity and add a Co-ordinate. You can also choose to Show the polygon only when a calculation condition is met.
Figure 33: Reference Polygon
The following example shows a reference polygon.
Figure 34: Reference Polygon Example
Trend Line
A Trend Line is a line indicating the general course or tendency of points on your chart. If you enable trend lines, you can choose a Regression Type (see below), choose a Trend Line Style and Trend Line Color, set the Regression Line Opacity and Regression Line Thickness, show a Regression Equation and customise a level of Equation Precision. You can also choose to display the Trend Line By Dim. (Dimension) Color.
Figure 35: Trend Line
To help you choose the regression type for your trendline, we've included some definitions here.
A Linear trendline is a best-fit straight line that is used with simple linear data sets.
A Power trendline is a curved line that is best used with data sets that compare measurements that increase at a specific rate.
An Exponential trendline is a curved line that is most useful when data values rise or fall at increasingly higher rates. You cannot create an exponential trendline if your data contains zero or negative values.
A Logarithmic trendline is a best-fit curved line that is most useful when the rate of change in the data increases or decreases quickly and then levels out. A logarithmic trendline can use negative and/or positive values.
A Polynomial trendline is a curved line that is used when data fluctuates. It is useful, for example, for analyzing gains and losses over a large data set.
The following example shows a linear trendline with the equation displayed to the right side of the chart.
Figure 36: Trend Line Example
Interactivity and Alternate State
The Interactivity tab enables the users to interact with chart data and navigate across the scatter chart for a better view of the data points.
Interactivity
Context Menu allows you to show (or hide) a Trend Line, Equation, Labels, a Legend, a Grid, Advanced Analytics and a Clusters Area. Allow Selections gives the user the ability to select the bubbles in the chart in order to pass selections back to the app. Allow Quick Select circumvents the selection confirmation steps and initiates the selections right away. Quick select suppresses the ability to multi-select, but that's where the lasso can be utilised. Enable Lasso allows users to draw a lasso circle with the mouse to interactively select multiple bubbles in one go. Enable Lasso Rectangle allows users to draw a lasso rectangle with the mouse to interactively select multiple bubbles at once.
Note: To use the lasso and lasso rectangle, click and drag an area of the chart, or, when interactive zooming is enabled, select the lasso button at the top right-hand corner.
Enable Interactive Zoom allows the user to navigate and to zoom in/out throughout the scatter chart to create a better view of the plotted data points.
Figure 37: Context Menu, Allow Selections, Allow Quick-Select, Enable Lasso, Enable Rectangle Lasso, Enable Interactive Zoom
Interactive Zoom Modes sets the number for the zoom level (Zoom in and Zoom out) from a choice of Free zooming, Fit, Custom% and Custom absolute. Show Tooltip activates the tooltip functionality which displays information about the bubble data point hovered over.
Figure 38: Interactive Zoom Modes, Show Tooltip
Enabling Show Guide Lines on Hover positions the points and magnifies the value on each axis when the cursor is held at that location. Alternative Measures count shows the badge next to the measure titles with the number of alternative measures available. Hide Cut Bubble Text hides bubble labels sticking out of the chart. Full screen Icon allows users to maximize and minimize objects. Snapshot Icon allows users to take snapshots of the object.
Note: Snapshot icon has been part of the Hover Menu since the Qlik Sense September 2020 release, and is no longer controlled using the property panel.
Figure 39: Show Guidelines on Hover, Alternative Measures Count, Hide Cut Bubble Text, Full Screen Icon, Snapshot Icon
Alternate State
Alternate State permits you to assign the Vizlib Scatter Chart to an alternate selection state. You can find more information on alternate states here.
Figure 40: Alternate State