Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleWatch video tutorial
Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width600px
urlhttp://youtube.com/watch?v=7Y8rQp3CRgc
height300px

...

Creating a Voronoi treemap

Here we describe how to create this chart using examples. Let's go step by step through the process with another example:

Rw ui steps macro
Rw step

Go to Data Search and open the required table.

Rw step

Perform the required operations to get the data you want to use in the chart.

Rw step

Click the gear icon on the toolbar and select Charts → Diagram → Voronoi treemap.

Rw step

Click and drag the column headers to the corresponding fields.

Image RemovedImage Added

Required field

Description

Data type

Signals

The variables to analyze, whose unique values will be represented as separate polygons in the diagram and thus will determine the number of polygons into which the diagram will be divided. You can add as many as you need to construct a hierarchy of subdivisions, which will be determined by the order of addition, the first corresponding to the top level and the last to the bottom level.

Any type but json or bigint

Value

The measuring variables whose values will be used to establish the proportions of each of the polygons. You can add more than one in order to have several measuring criteria but they cannot be used at the same time. You can switch between them inside the diagram but the first you add will be used by default.

float, integer, duration

Rw step

The Voronoi treemap is displayed. This is a visual depiction of the average response length of the connections to Devo in each city and with each response time over one day. 

Image RemovedImage Added

Customizing the Voronoi treemap

Expand
titleConfiguration options

Several options for customizing how you want to visualize this information appear above the treemap:

...

Configuration options
Expand
title

Size by

This dropdown contains those variables added to the value field when generating the treemap. You can switch between them to use their values as the criteria to establish the proportions of the cells.
In this example, you can choose between determining cell size based on the average response length (avg_responseLength) for each grouping occurrence (city-responseTime) or the number of events for each grouping occurrence (Count).

Color by

By default, cell colors are applied randomly without any color spectrum that visually correlates cells and values. This dropdown contains those variables added to the value field when generating the treemap and selecting one of them will establish a color spectrum using its minimum and maximum values as cardinal points (green-red). Cells will be colored to reflect the position of their value inside that spectrum.

Partitioning

By default, cell outlines are colored in black without using a pattern that visually correlates outlines and values. This dropdown contains those variables added to the value field when generating the treemap and selecting one of them will color the cell outlines to reflect the status of their values in relation to the optimal status (green to red).

Search

Enter text to search for a value in the Voronoi map. The cells containing the specified string will be highlighted, together with their children if any.

Filter

Enter text to filter the chart by a specific value. Only the cells matching the string will be shown, together with their children if any.

Legend

This is a path that lists the fields added as signals. The first signal in the path is the primary cell grouping, followed by subsequent groupings. Click and drag to change the order of the signals in the path to change the grouping order for cells in the chart.

Values

When drilling-down into the cells, this shows the values of each grouping.

Expand
titleVisualization options

Click the information icon to display a list of keyboard shortcuts that you will use to navigate the chart and to modify its style and layout:

...

title
Expand

Visualization options

Status
titleT
Treemap

Cells are drawn from left to right according to their weight (from larger to smaller).

Status
titleF
Fisheye

Larger cells appear in the center.

Status
titleB
Blackhole

Smaller cells appear in the center.

Status
titleR
Random

Cells are randomly distributed.

Status
titleO
Ordered

Cells are drawn from top to bottom according to their weight (from larger to smaller). A cell's size corresponds to its weight.

Status
titleS
Squarified Treemap

Cells are rectangular and drawn from left to right according to their weight (from larger to smaller). A cell's size corresponds to its weight.

Status
titleD
Squarified Ordered

Cells are rectangular and drawn from top to bottom according to their weight (from larger to smaller). A cell's size corresponds to its weight.

Status
titleP
Flattened / Not Flattened visualization

Flattened visualization of all branches, without having to do a drill-down. The Flattened option can be applied to all previous visualization options. Pressing P again will return it to the normal visualization.

Expand
titleNavigation options

There several ways to navigate the Voronoi treemap which are applicable to all visualization options:

...

Navigation options
Expand
title

Left click

Select group, click again to deselect.

Status
titleCTRL
+ Left click

Select multiple groups.

Left double click

Expose group.

Status
titleSHIFT
+ Left double click

Focus on a group. Select a group of cells and analyze them as if they were a separate Voronoi map.

Left click-and-hold

Open a group of cells (drill-down).

Right double click 

Close group.

Status
titleSHIFT
+ Right double click

Blur group.

Right click-and-hold

Close group.

Mouse wheel

Zoom in / out

Mouse drag

Pan around zoomed visualization.

Status
titleESC

Unexpose & close all groups.

Status
titleG

Displays detailed information in each cell. Left-click on the cell and then press G. A panel will open to the right to display the following information:

  • Number of children (0 if it is the last branch).

  • Total number of nodes.

  • All parents (0 if it is the top branch).

  • Aggregated values and percentage of the total.

Compare multiple cells:

  • Press CTRL and click cells to add them to the lower part of the right panel to see their information (children, nodes, parents and aggregated values).

  • Hover over a cell (without clicking) to see its information at the top of the right panel and compare it to the previously added cells. The differences will be shown in red if the values are worse and green if the values are better.

Status
title%

Show/hide percentage in the legend.

Status
titleV

Show/hide value in the legend.

Status
titleA

Show/hide the percentage of the total in the legend.

Status
titleZ

Show/hide zero values.

Status
titleL

Calculate cell proportions using a logarithmic value to normalize size. This way, nodes with 20% of the total weight can be the same size as nodes with 5% of the total weight. This option is recommended when having very polarized values and needing an exhaustive approach in which value omission is not admissible for the purpose of the analysis. This way, we avoid having very tiny cells that might be almost invisible or even omitted from the diagram.

Status
titleN

Calculate cell proportions using real aggregated values so a cell's size corresponds to its weight. Nodes with 20% of the total weight will represent 20% of map's total size, whereas nodes with 1% of the total weight may not even be seen. This option is recommended when needing a generalistic approach in which marginal values can be omitted without substantially affecting the analysis. This way the correspondence of values and sizes can be easily identified at a glance.

Status
titleM

Show/hide values as bytes.

Status
titleC

Show/hide values as time (Chrono style).

Status
title?

Show/hide this help.

...

Expand
titleExample 1

Visualization of the average response length (avg_responseLength column) per city over the last day and comparison of three of the cities.

  • Press 

    Status
    titleG
     and select Knoxville and Alcorcon by pressing 
    Status
    titleCtrl
     + clicking the cells. Move the mouse over the Madrid cell to compare it to the other ones. 

The cells selected will appear at the lower part of the right panel while the cell over which you hover will appear at the top, showing in both cases their information and aggregated values. The one at the top will be compared to those at the bottom, showing their differences in red or green (fewer or worse).

  • Hit the 

    Status
    titleG
     key again when you finish to go back and remove the comparison panel to the right.

Image RemovedImage Added
Expand
titleExample 2

Visualization of the average response length (avg_responseLength column) per city over the last day, ordered by size and colored using a spectrum based on the average response length (avg_responseLength column).

  • Press 

    Status
    titleD
     to apply the Squarified Ordered visualization.

  • Press 

    Status
    titleN
     to calculate cell size using their weight.

  • Select avg_responseLength in the Color by field.

The spectrum of colors shows the average response length (maximum is red, minimum is green) and the cell size represents also the average response length (the larger they are, the longer the response). With this visualization, we establish a correlation between size and color, making it easier to spot potential problems by looking at big red cells.

Image RemovedImage Added

Query example

You can recreate the example explained above with the data from the following query and mapping the fields as follows:

...