The pie chart displays the contribution of several data items into a total as sectors of a circle. The sector arcs are proportional to the corresponding data item values. The data items in this chart cannot take negative values. If the total of all data items is 0, no sectors are displayed.
To create a pie chart
- Drag the Pie Chart element from the Analysis palette into the graphical editor.
- In the Data section of the chart’s Properties, configure the data item.
- Specify the title for the data item in the Title box. This text will be shown in the chart legend.
- Enter the expression that will be dynamically evaluated to obtain the current value of the data item in the Value box.
- Specify the color for this data item’s bar. Click the colored box to choose the custom color using the color picker, or use the edit box on the color picker’s right to adjust the color’s transparency.
When finished, specify additional data items you want to be displayed in your chart.
To add a data item
By default, a new pie chart already has two data items. If you want to add another, follow these steps:
- Select the pie chart in the graphical editor or in the Projects view.
- Go to the Data section of the Properties view.
- Click the Add button. A new property section with settings for one more data item will appear below.
To remove a data item
- Select the pie chart in the graphical editor or in the Projects view.
- Go to the Data section of the Properties view.
- Locate the section defining the data item you want to remove from the pie chart.
- In this section, click the button.
- General
-
Name — The name of the chart. The name is used to identify and access the chart from the code.
Ignore — If selected, the chart is excluded from the model.
Lock — If selected, the chart is locked, so it could not be selected in the graphical editor with a mouse click. Model developers would not be able to move it, resize, or modify its properties anyhow, unless the chart is unlocked.
- Data
-
Depending on the type of the chart, one or more data items may already be present in its properties.
Add — This button opens a new property section, which allows for configuring the data you want to visualize on this chart.
Title — The title for this data item. It will be shown in the chart legend.
Value — The expression which dynamically evaluates the data item value.
Color — The color of the data item value on the chart. Click the colored box to choose the custom color using the color picker, or use the edit box on the color picker’s right to adjust the color’s transparency.
Use the and arrows to arrange the order of the data item sections.
To remove the data item from the chart, click the button below the data item’s property section.
- Data update
-
Update data automatically — If selected, new data samples will be added automatically with the specified Recurrence time. You can also specify whether you want to Use model time or Use calendar dates. Depending on this choice, you can specify when to start updating using either the First update time or Update date properties.
- Legend
-
Show legend — If selected, the chart legend is displayed.
Position — [Enabled if Show legend is selected] Sets the legend position (relative to the chart).
Area size — [Enabled if Show legend is selected] The size of the area allocated for the chart legend.
For the North and South positions, this setting affects the area’s height. For the East and West positions, this setting affects the area’s width.Text color — The color of the legend’s text. Click the colored box to choose the custom color using the color picker.
To adjust the text’s transparency, use the edit box on the color picker’s right. - Appearance
-
Background color — The background color of the chart. Click the colored box to choose the custom color using the color picker, or use the edit box on the color picker’s right to adjust the color’s transparency.
Border color — The chart border color. Click the colored box to choose the custom color using the color picker, or use the edit box on the color picker’s right to adjust the color’s transparency.
- Position and size
-
Level — The level this chart belongs to.
X — The x-coordinate of the chart’s upper left corner.
Y — The y-coordinate of the chart’s upper left corner.
Width — The width of the chart shape (in pixels).
Height — The height of the chart shape (in pixels).
- Chart area
-
This section defines the visual properties of the chart area.
X Offset — The x-offset of the chart area relative to the whole area allocated for the chart and all its accompanying elements.
Y Offset — The y-offset of the chart area relative to the whole area allocated for the chart and all its accompanying elements.
Width — The width of the chart area (in pixels).
Height — The height of the chart area (in pixels).
- Data items
-
Function Description void addDataItem(DataItem di) Adds a DataItem data item to the chart with the default title and color.
di — the data item to addvoid addDataItem(DataItem di, String title, Color color) Adds a data item to the chart.
di — the data item to add
title — the data item title
color — the color to associate with this data itemint getCount() Returns the number of data items currently displayed by this chart. DataItem get(int i) Returns the chart item (DataItem, DataSet, HistogramData, and so on) with the given index i.
i — the index of the itemString getTitle(int i) Returns the title of the chart item (DataItem, DataSet, etc.) with the given index i.
i — the index of the itemColor getColor(int i) Returns the color of the chart item (DataItem, DataSet) with the given index.
i — the index of the itemvoid setColor(int i, Color c) Sets the new color of the chart item (DataItem, DataSet) with the given index.
i — the index of the item
c — the new color of the itemvoid remove(int i) Removes the item (DataItem, DataSet, etc.) with the given index i from the chart.
i — The index of the data element.int remove(ChartItem ci) Removes the given item ci (DataItem, DataSet) from the chart.
ci — The item to remove.void removeAll() Removes all items from the chart. - Selecting data items
-
Function Description void selectItem(int itemIndex, boolean selected) Selects or deselects (depending on the selected value) the chart item with the given index.
itemIndex — The index of the data element.
select — sets whether to select or deselect the element.void setSelectedItemIndices(int[] selectedIndices) Selects only the chart items with the given indices.
selectedIndices — an array with indices of the chart items to select (other chart items will be deselected), can be null — this clears the selectionint[] getSelectedItemIndices() Returns the number of data items currently displayed by this chart. - Updating chart data manually
-
Function Description void updateData() Updates all data items displayed by this chart. - Location
-
Function Description double getX() Returns the X coordinate of the chart (namely, the X coordinate of its upper left corner). double getY() Returns the Y coordinate of the chart (namely, the Y coordinate of its upper left corner). void setX(double x) Sets the X coordinate of the chart.
x — the new value of the X coordinatevoid setY(double y) Sets the Y coordinate of the chart.
y — the new value of the Y coordinatevoid setPos(double x, double y) Sets new coordinates for the chart shape.
x — the new value of the X coordinate
y — the new value of the Y coordinate - Size
-
Function Description double getWidth() Returns the width of the chart shape. double getHeight() Returns the height of the chart shape. void setWidth(double width) Sets the new width for the chart shape.
width — the new value of the chart widthvoid setHeight(double height) Sets the new height for the chart shape.
height — the new value of the chart height - Visibility
-
Function Description boolean isVisible() Checks the visibility of the chart. Returns true if the chart is visible, and false otherwise. void setVisible(boolean v) Sets the visibility of the chart.
v — visibility: if true — the chart is set to be visible, if false — not visible.
-
How can we improve this article?
-