# hist

Creates a histogram in an axis.

## Syntax

hist(y)

hist(y, x)

hist(y, binnum)

hist(…, property, value, …)

hist(hAxes, …)

nums = hist(…)

[nums, xs] = hist(…)

## Inputs

y
Values of the histogram.
Type: double | integer
Dimension: vector | matrix
x
Centers of the bins.
Type: double | integer
Dimension: vector
binnum
Number of bins; defaults to 10 bins if omitted.
Type: integer
Dimension: scalar
property
Properties that control the appearance or behavior of the graphics object.
Type: string
Dimension: scalar
value
Value of the properties.
Type: double | integer | string
Dimension: scalar | vector
hAxes
Axis handle.
Type: double
Dimension: scalar

## Outputs

nums
A vector of the numbers of elements in each bin.
xs
A vector of the x values of each bin.

## Example

Simple hist example:

clf;
d=normrnd(5,2,1,1000);
hist(d);

hist example with a return value:

clf;
d=normrnd(5,2,1,1000);
[nums, xs]=hist(d);
bar(xs, nums);

If there is no axis, one will be created first. If bins is omitted, the default number of bins is 10. If the first argument of hist() is an axes handle, hists will be created in that axes.

With return values assigned, hist will not create a histogram, but rather calculate the number of elements in each bin(nums) and/or centers of each bin(xs). The histogram can be created with the command 'bar(xs, nums)'.