Accelerating the pace of engineering and science

# Documentation Center

• Trial Software
• Product Updates

# pie3

3-D 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.

• 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

expand all

### Create 3-D Pie Chart

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)
```

### Specify Text Labels for 3-D Pie Chart

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

```x = 1:3;
labels = {'Taxes','Expenses','Profit'};

figure
pie3(x,labels)
```

## See Also

Was this topic helpful?