Pie chart
A pie chart shows the ratio between the values as slices of a circle (donut). Each slice shows a value fraction of the whole (of 100%).
Use a pie chart to show the proportion of data attribute values.
Case examples:
-
show the distribution of the mean area of buildings built in different periods of time:
-
show percentage distribution of buildings with different purposes:
Main features
-
The grouping attribute defines what data slices are displayed. As a grouping attribute, you can select:
- Text attributes: for example, firm category, building purpose, and others.
- Numeric attributes: for example, number of reviews, building area, and others. To display data as multiple slices, specify the number of ranges and their limits in the Number of ranges field when creating a widget or editing it. You can set up ranges of different sizes. The specified upper limit is not included in the range.
-
The aggregation attribute defines the size of slices. Aggregation is performed within one group or range. As an aggregation attribute, you can select:
- Number of objects: to count the number of values in a group or range.
- Numeric attributes: to count the total, mean, minimum, or maximum value of this attribute within each group using aggregation functions.
-
A pie chart is suitable for displaying a small number of aggregation attribute values, e.g. for the top 5. If there are more attributes and some of them take up a small part of the pie, they will be displayed on the chart as narrow slices that are difficult to see on the widget.
-
By default, the chart displays the top 5 or top 10 attribute values: you can specify the number when creating a widget or editing it in the Number of values field. To create the distribution across all attributes in the sample, group the values that are not in the top: to do this, select the Show other checkbox.
-
To see percentages, when creating a widget or editing it, select the Values in percentage checkbox.
Creating a widget

-
Go to the Dashboards tab.
-
Select the required dashboard.
-
Click
icon.
-
Click
icon next to the required layer and select Create widget.
-
Specify the required parameters:
- Layer: data layer that is used to build a graph on the widget.
- Grouping attribute: attribute that is used to group data.
- Aggregation attribute: attribute that is used to aggregate data and calculate the values. If you want to display only the number of values, select Number of objects.
- Aggregation type: function that is used to calculate aggregation attribute values. Aggregation is performed within each group or range of data.
-
Set the remaining widget parameters if necessary.
-
Click Create.
Note
When working with the uploaded data, make sure that at least one attribute is specified in it to build a graph on the widget.
Parameters
General widget settings
Parameter |
Description |
---|---|
Widget name | Widget name. |
Layer | Data layer that is used to build a graph on the widget. |
Description | Text description of the widget. You can format the text: customize headings; make the text bold, italic, or underline the text; add a link; select the text color from the palette or specify it in RGB, HSL, or HEX format. |
Change widget type | Click to select another widget type from the list. The configured widget parameters are saved. |
Circle slices
Parameter |
Description |
---|---|
Grouping attribute | Attribute that is used to group data on the graph. The grouping attribute defines what data slices of a circle are displayed. |
Aggregation attribute | Number of objects or a numeric attribute that is used to aggregate data on the graph. Aggregation is performed within each group or range of data. The aggregation attribute defines the size of circle slices. |
Aggregation type | Function that is used to calculate aggregation attribute values in each group or range of data:
|
Number of values | For text grouping attributes only. The number of slices that are displayed on the graph: the top 5 or top 10 values from the sample. The top values are calculated based on the aggregation attribute. |
Show other | For text grouping attributes only. The last slice on the graph shows the sum of the last value in the top and the remaining values in the sample below this position. The top values are calculated based on the aggregation attribute. |
Number of ranges | For numeric grouping attributes only. The number of ranges (slices) that are displayed on the graph. The available number of ranges depends on the data, the maximum number is 10. Ranges are calculated automatically, but you can set them manually by entering the required range limits. The specified upper limit is not included in the range. To add a range, click |
Color
Parameter |
Description |
---|---|
Color | Selecting a color scale (a set of prepared color samples) according to which elements on the graph are colored. |
Legend
Parameter |
Description |
---|---|
Show legend | Shows the values of the grouping attribute and the corresponding values of the aggregation attribute. |
Values in percentage | Shows the values of the aggregation attribute as a percentage. |
Additional settings
Parameter |
Description |
---|---|
Show source | Name of the data layer and the aggregation attribute. |
Show empty ranges | For numeric grouping attributes only. Shows on the graph the ranges of values without data. |
Total value | The sum of the values of the aggregation attribute in the sample. |
Mean value | The mean value of the aggregation attribute in the sample. |
Minimum value | The minimum value of the aggregation attribute in the sample. |
Maximum value | The maximum value of the aggregation attribute in the sample. |
Total objects in the asset | Number of objects in the sample that is used to calculate the values. |
What's next?
- Get to know more about other Widgets types.
- See available Operations with widgets.
- Quick start.
- Get to know how to work with Data and Data visualization.
- Get to know more about Layers and Dashboards.
- Get to know prepared Analytics presets.