MATLAB Function Reference

pie3

Three-dimensional pie chart

Syntax

• pie3(X)
  pie3(X,explode)
  pie3(...,labels)
  pie3(axes_handle,...)
  h = pie3(...)
  

Description

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

pie3(X,explode) specifies whether to offset a slice from the center of the pie chart. X(i,j) is offset from the center of the pie chart if explode(i,j) is nonzero. explode must be the same size as X.

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

• pie3(1:3,{'Taxes','Expenses','Profit'})
  

pie3(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, surface, 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

Offset a slice in the pie chart by setting the corresponding explode element to 1:

• x = [1 3 0.5 2.5 2];
  explode = [0 1 0 0 0];
  pie3(x,explode)
  colormap hsv
  
  
  

See Also

pie

pie

pinv

© 1994-2005 The MathWorks, Inc.