Voronoi diagram widgets
- Juan Tomás Alonso Nieto (Deactivated)
- Borja Moro Moreno
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 |
|---|---|---|
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. 
|
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.
|
Levels | This setting controls how the hierarchical levels are displayed.
| |
Shape | This field appears only when Relaxed is selected as the Layout setting. These options offer different ways of drawing the diagram's cells.
| |
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.
| |
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 |