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).
You can use this source query and map these fields to recreate the example shown above:
query(from siem.logtrust.web.activity
where isnotnull(country), isnotnull(city)
group by city, country, responseTime
every -
select avg(responseLength) as avg_responseLength,
count() as count)| Required field | Column added |
|---|---|
| Keys | country city |
| Value | count |
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.
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
Once you add the query to your Voronoi widget, the variables will be automatically assigned and the diagram constructed. However, after that, you will be able to choose the variables you want to use, both to construct the hierarchy of polygons and to establish their proportions. This is performed in the visual settings of the widget, which can be found in the Visual tab. The settings in the Data tab 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 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.
|
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. | |
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.
| |
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.
| |
Shape | This field appears only when Relaxed is selected as the Layout setting. These options offer different ways of drawing the diagram's cells.
| |
Borders | Border radius | 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. |
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.