pie (MATLAB Functions)

Pie chart

Syntax

pie(X)
pie(X,explode)
pie(...,labels)
pie(axes_handle,...)
h = pie(...)

Description

pie(X) draws a pie chart using the data in X. Each element in X is represented as a slice in the pie chart.

pie(X,explode) offsets a slice from the pie. explode is a vector or matrix of zeros and nonzeros that correspond to X. A nonzero value offsets the corresponding slice from the center of the pie chart, so that X(i,j) is offset from the center if explode(i,j) is nonzero. explode must be the same size as X.

pie(...,labels) specifies text labels for the slices. The number of labels must equal the number of elements in X. For example,

```
pie(1:3,{'Taxes','Expenses','Profit'})
```

pie(axes_handle,...) plots into the axes with handle axes_handle instead of the current axes (gca).

h = pie(...) returns a vector of handles to patch and text graphics objects.

Remarks

The values in X are normalized via X/sum(X) to determine the area of each slice of the pie. If sum(X)1, the values in X directly specify the area of the pie slices. MATLAB draws only a partial pie if sum(X)<1.

Examples

Emphasize the second slice in the chart by setting its corresponding explode element to 1.

x = [1 3 0.5 2.5 2];
explode = [0 1 0 0 0];
pie(x,explode)
colormap jet

See Also

pie3

pi pie3