Accelerating the pace of engineering and science

# pareto

Pareto chart

pareto(Y)
pareto(Y,names)
pareto(Y,X)
H = pareto(...)

## Description

Pareto charts display the values in the vector Y as bars drawn in descending order. Values in Y must be nonnegative and not include NaNs. Only the first 95% of the cumulative distribution is displayed.

pareto(Y) labels each bar with its element index in Y and also plots a line displaying the cumulative sum of Y.

pareto(Y,names) labels each bar with the associated name in the string matrix or cell array names.

pareto(Y,X) labels each bar with the associated value from X.

pareto(ax,..) plots into the axes ax rather than the current axes, gca.

H = pareto(...) returns handles to the primitive line and bar series objects created.

## Examples

expand all

### Create Pareto Chart

Create a Pareto chart of vector y.

y = [90,75,30,60,5,40,40,5];
figure
pareto(y)

pareto displays the elements in y as bars in descending order and labels each bar with its index in y. Since pareto displays only the first 95% of the cumulative distribution, some elements in y are not displayed.

### Label Bars in Pareto Chart

Examine the cumulative productivity of a group of programmers to see how normal its distribution is. Label each bar with the name of the programmer.

codelines = [200 120 555 608 1024 101 57 687];
coders = {'Fred','Ginger','Norman','Max','Julia','Wally','Heidi','Pat'};

figure
pareto(codelines, coders)
title('Lines of Code by Programmer')

expand all

### Tips

You can use pareto to display the output of hist, even for vectors that include negative numbers. Because only the first 95 percent of values are displayed, one or more of the smallest bars may not appear. If you extend the Xlim of your chart, you can display all the values, but the new bars will not be labeled.

You cannot place datatips (use the Datacursor tool) on graphs created with pareto.