Document toolboxDocument toolbox

Voronoi diagram widgets

About voronoi diagram widgets

In this widget, you can see the values of the fields you add, portrayed as a tessellation of polygons whose proportions depend on a numeric field 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 fields, 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 activate the 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 fields 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 fields 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 disposition consisting of cells represented as near-round polygons, which are distributed as specified in the shape setting. It is designed to render all values visible, establishing a proportional sense that allows for the recognition of size variations, even if it does not necessarily match the actual proportions.

  • 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:

  • You can double click on a cell to drill down to view the contents of each component as needed. This is 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.

Visualization settings

Each setting contributes to the overall appearance of the diagram, and specific combinations may lead to less precise cell proportions. It's important to consider this when adjusting settings in order to achieve a design that best suits your requirements.

For instance, the Relaxed layout option does not accurately represent cell proportions but provides approximate estimations. Different shape options may adjust these proportions, bringing them closer to or further from their current size, but never matching it accurately.

Query example

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

query(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