Voronoi diagram widgets

Watch video tutorial

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
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.
Fields	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 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.
Font	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
Keys	city
Weight	count