MATLAB Function Reference

pie - Pie chart

GUI Alternatives

To graph selected variables, use the Plot Selector in the Workspace Browser, or use the Figure Palette Plot Catalog. Manipulate graphs in plot edit mode with the Property Editor. For details, see Plotting Tools — Interactive Plotting in the MATLAB^® Graphics documentation and Creating Graphics from the Workspace Browser in the MATLAB Desktop Tools documentation.

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 the handle axes_handle instead of into 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