Document toolboxDocument toolbox

Voronoi diagram widgets

In this widget, you can see the values of the columns you add, portrayed as a tessellation of polygons whose proportions depend on a numeric column you choose. These polygons may be subdivided into smaller polygons and constitute a hierarchical structure with as many levels as you establish (there is a legend above the chart explaining the hierarchy of data).

What data do I need for this widget?

To create a Voronoi widget, your query must contain at least two columns, one of them with numeric values. Furthermore, it is highly advisable to group your data by at least two keys using a no-time option to limit the scope of your analysis in terms of interrelation. Also, it is highly advisable to add some aggregation functions to provide mathematical significance to the variables you want to analyze.

Time grouping

If you grouped using a time option, the diagram will only show the data for the latest period available for the selected time range specified.

Widget settings

To edit the widget settings, you must first be in Edit mode.

Click the widget title bar to open its settings. Alternatively, the settings are accessible via the Ellipsis icon → Properties. The widget settings are contained in three tabs, Data, Visual, and Raw.

The settings in the Data and Raw tabs are described in the Create a widget article. These are the Visual settings for the Voronoi chart widget:

Category

Setting

Description

Category

Setting

Description

Fields

 

Keys

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. The available options will correspond to all the columns present in the query, or only the grouping attributes if your query groups data. You can select as many as you want and they will construct the hierarchy of subdivisions, which will be determined by the order, the first corresponding to the top level and the last to the bottom level.

  • Click inside the field and a dropdown will open with the options. Select one and repeat the process to keep adding variables.

  • If the order does not suit your needs, click and drag to reorder the fields inside this box.

  • Click the cross inside each variable to remove it or the one on the right to remove all of them.

Weight

The measuring variable whose values will be used to establish the proportions of each of the polygons. The available options will correspond to the numeric columns in the query (including aggregations). You can select only one but you can switch between them at any moment by clicking on the field and selecting one from the dropdown.

General

Max groups per level

Only the number of nodes specified will be shown, starting with the biggest nodes. An extra node will be generated to group the rest of them beyond the limit.

Chart styles

Layout

This setting determines the overall style that will be used for the display of the diagram. Choose from Relaxed (default), Ordered, and Squarified.

  • Relaxed: a random cell disposition with no pattern that determines the way they are shaped and ordered.

  • Ordered: a disposition consisting of rectangle-shaped cells ordered by size from top to bottom.

  • Squarified: a disposition consisting of rectangle-shaped cells ordered by size from left to right.

Levels

This setting controls how the hierarchical levels are displayed.

  • The default, Hierarchical, displays one level on top of another with a semi-transparent design to show the content below. This is useful when you want to appreciate more clearly the distribution of the highest-level groups in the diagram. However, in order to see the details for the lower levels by hovering over, you'll need to double click to drill down in a group. Hit the ESC key to restore the default view.

  • Flattened fits all levels into the same plane using size and position to denote a group's location within the hierarchy. This allows you to mouse-over the diagram and see the details for each group and level in tooltips without needing to drill-down in any group.

Shape

This field appears only when Relaxed is selected as the Layout setting. These options offer different ways of drawing the diagram's cells.

  • Fisheye: larger cells appear in the center.

  • Blackhole: smaller cells appear in the center.

  • Random: cells are randomly distributed.

  • Ordered: cells are drawn from top to bottom according to their weight (from larger to smaller).

  • Squarified: cells are drawn from left to right according to their weight (from larger to smaller)

Cell labeling

This field appears only when Flattened is selected as the Levels setting. The two options, Stab and Floating, offer different ways to arrange a flattened diagram.

  • Stab: the top-level cells of each group are placed at the top.

  • Floating: the top-level cells of each group are placed at the top left corner.

Borders

Rounding

This defines the radius of the element's corners in pixels. The default is .15. Increase this value to make the corners of the cells more rounded.

External gap

Regulates the space between the cells in the diagram measured in pixels. Increase this value to create more separation between cells in the diagram.

Internal gap

Regulates the space between the border of a cell and its contents.

Colors

Start color and End color

Together, these define the color spectrum that is used to shade the cells in the diagram.

Label dark color

The color of the font used when the cell background color is light.

Label light color

The color of the font used when the cell background color is dark.

Font

 

Weight

Sets the font weight used for displaying the KPI. Choose from Normal, Thin, Extra Light, Light, Medium, Semi Bold, Bold, Extra Bold and Black.

Style

The font style. Choose from Normal, Italic and Initial.

Performance

Max groups

The hard limit on the number of groups Voronoi will attempt to include in a single visualization. The limit is there to prevent excessive memory usage when browsing very deep hierarchies.

Tips for using a Voronoi widget

These diagrams are dynamic, allowing you to double click on a cell to drill down to view the contents of each component as needed. These are useful when you want to get a sense of the proportional breakdown of the whole into its components and sub-components. To zoom out one level, simply double-right-click on the cell; to fully zoom out, press the Esc key.

See the Voronoi treemap article if you want to use the Voronoi in the Data Search.

Query example

This is the source query used and the fields mapped to generate the widget shown above:

qquery(from siem.logtrust.web.activity where not isempty(city) where not isempty(country) where isnotnull(city), isnotnull(country) group by city, country, responseTime select avg(responseLength) as avg_responseLength, count() as count

Keys

country

city

Weight

count