Pie/Donut chart
Pie charts (also circle graphs or pie diagrams) represent the values as pieces of a whole. This is visualized as parts of a circle.
Simple pie chart:
If several measured values are available, they are displayed as rings of a circle. In the following image, 2 measured values are displayed:
The following additional options apply to pie charts:
(1) Donut max. outer radius: These are the outer dimensions of the circle specified in % of the available area.
(2) Donut max. inner radius: This is the inner cavity, the 'center hole in the donut' specified in % of the available area.
(3) Donut gap: This is the spacing of the rings specified in % of the available area.
The width of the rings is automatically determined by the above parameters. Again, meaningless values can visually disfigure the pie chart.
The 'Enable 3D' setting is also available for pie charts. However, it is important to note here that optical errors can very easily occur in the interaction with several measured values (i.e. the display of the measured values in rings). The display does not model the real spacing, but draws the rings one after the other.
|
|
As can be seen in the example on the left, this results in an incorrect spatial representation. This cannot be prevented in principle, but a good compromise can be found by adjusting the parameters (1)-(3), as shown in the example on the right. |
Processing input data
The data of a measured value can be processed further via the 'Item click' and 'Item double click' triggering behaviour.
The object that is passed to the configured behaviour as input data is primarily a data provider, which contains all raw data sets that have been aggregated to the clicked value.
Tip: With the action 'Show raw data of dashboard' this raw data can be displayed in a grid.
Furthermore, this object offers other data fields:
Data field |
Description |
||||||||
value |
The value that was clicked |
||||||||
category |
The value of the category |
||||||||
categoryLabel |
The category label |
||||||||
series |
The series configuration, which in turn contains the following data fields:
|
Example
|
Click on a series value. |
As configured in the behaviour on the far left, the note shows 'category' as the title, and 'series.label' and 'value' as the message. |
Special legend settings
In addition to the general legend settings, the appearance of the value ("Value appearance") can also be configured for a pie chart.
You can choose between three modes:
Mode |
Explanation |
Example |
Value |
Only displays the value of the category |
12 |
Percent |
Only displays the percentage value of the category |
35% |
Value and percent |
Displays value and percentage of the category |
12 (35%) |