Pie Chart Widget

The Pie Chart widget is a graphical representation of data by means of pie wedges. A simple situation is when a 1-dimensional identifier such as the Supply(f) of a factory f in the TransNet application (see the “Quick Start: My First WebUI” section) is displayed like in the following picture:

_images/PieChart-1dimEx.png

More generally, a pie chart widget offers the possibility to display multi-dimensional data in your model by displaying a wedge for each data point. The surface of a wedge provides information about the value of the corresponding data point. For example, in the TransNet application, the transport amounts for every combination (factory, center) may be represented using a pie chart widget like illustrated in more details in the sequel. More specifically, we discuss and illustrate below one-by-one the tabs in the pie chart’s options editor.

Contents and Pivoting

In order to determine the information to be rendered by a pie chart, first one has to specify the data identifier(s) in the Contents tab of the widget’s options editor, where one may search for the available model data using the corresponding functionality at the bottom:

_images/PieChart-Contents.png

Next, in the Pivot tab of the options editor, one can specify how the data dimensions are to be organized in the chart. For example, if both the factory index f and the center index c are specified in the Wedges section and the <IDENTIFIER-SET> in the Totals section then the resulting pie chart looks like in the picture below on the right:

_images/PieChart-View1.png

One may move some data indexes in the Totals section of the Pivot tab. In our example, moving the center index f to the Totals section results in the following pie chart view:

_images/PieChart-View2.png

So, now for every center c there is one wedge in the chart representing the total transport to this center from all factories.

Change Type

In the Change Type tab of the widget’s options editor, one can switch from the pie chart type to some other representation type. In the example at hand, one can switch e.g.. from the pie chart to the table, resulting in the tabular view of the same data values:

_images/PieChart-ViewChangeType.png

Totals

In the Totals tab of the widget’s options editor, aggregated values such as sum, mean, count, min, or max computed over one of the data indexes my be added to the chart. In our example, if we add the sum over the centers c to our example pie chart, three additional (gray) wedges representing the aggregated values become visible in the chart:

_images/PieChart-ViewTotals.png

Identifier Settings

In the Identifier Settings tab of the widget’s options editor, one can apply a display domain or some slicing to the data identifier(s).

The “Set display domain” section works in the same way as for e.g.. the bar chart.

In the “Set slicing per index” section it is possible to slice one index to another index of a subset, to an element parameter or to a fixed element in the corresponding set. For instance, we can slice our factory index f to the fixed element ‘Zurich’ in the Factories set, resulting in the pie chart view as shown here:

_images/PieChart-ViewSlice.png

Similarly, one could slice the index f to an element parameter CurrentFactory having the declared range the set Factories (where the value of CurrentFactory may be determined from within the model or by a choice made through another widget in the user interface).

Widget Extensions

In the Widget Extensions tab, it is possible to add the string parameters configured for the Widget Actions and the Item Actions for the widget.

_images/WidgetActions_PieChart.png _images/ItemActions_PieChart.png

Hover and Select

In the pie chart one may select one wedge by clicking on it. In this case, the selected wedge is highlighted, while the other wedges are faded away. The picture below depicts this situation:

_images/PieChart-ViewSelect.png

When a wedge has been selected, the user may still hover over another wedge and inspect the tooltip information, in the same way as the hovering works when no wedge has been selected (remark: a selected wedge may be unselected by clicking again on it):

_images/PieChart-ViewHover.png

Miscellaneous

In the Miscellaneous tab of the pie chart’s options editor, other options may be set such as the title of the widget, whether or not the widget is visible (this may be determined by a model parameter) or the number of decimals for the values displayed in the chart.