Main Content

pie3

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.

  • If sum(X) ≤ 1, then the values in X directly specify the area of the pie slices. pie3 draws only a partial pie if sum(X) < 1.

  • If the sum of the elements in X is greater than one, then pie3 normalizes the values by X/sum(X) to determine the area of each slice of the pie.

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.

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

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

Examples

collapse all

Create a 3-D pie chart of vector x.

x = [1,3,0.5,2.5,2];
figure
pie3(x)

To offset the second pie slice, set the corresponding explode element to 1.

explode = [0,1,0,0,0];
figure
pie3(x,explode)

Create a 3-D pie chart and specify the text labels.

x = 1:3;
labels = {'Taxes','Expenses','Profit'};
    
figure
pie3(x,labels)

Create vectors y2010 and y2011, that contain financial data for two years. Then create a cell array containing the labels for the values.

y2010 = [50 0 100 95];
y2011 = [65 22 97 120];
labels = {'Investments','Cash','Operations','Sales'};

Create a 2-by-1 tiled chart layout, and display a pie chart and legend for y2010 data in the first tile. Then display a pie chart and legend for the y2011 data in the second tile.

t = tiledlayout (2,1);
ax1 = nexttile;
pie3(ax1,y2010)
title('2010')
legend(labels)

ax2 = nexttile;
pie3(ax2,y2011)
title('2011')
legend(labels)

Compatibility Considerations

expand all

Behavior changed in R2019b

Extended Capabilities

See Also

Introduced before R2006a