This is documentation for an old release of SciPy (version 0.12.0). Read this page Search for this page in the documentation of the latest stable release (version 1.15.1).

scipy.stats.histogram

scipy.stats.histogram(a, numbins=10, defaultlimits=None, weights=None, printextras=False)

Separates the range into several bins and returns the number of instances in each bin.

Parameters :

a : array_like

Array of scores which will be put into bins.

numbins : int, optional

The number of bins to use for the histogram. Default is 10.

defaultlimits : tuple (lower, upper), optional

The lower and upper values for the range of the histogram. If no value is given, a range slightly larger then the range of the values in a is used. Specifically (a.min() - s, a.max() + s),

where s = (1/2)(a.max() - a.min()) / (numbins - 1).

weights : array_like, optional

The weights for each value in a. Default is None, which gives each value a weight of 1.0

printextras : bool, optional

If True, the number of extra points is printed to standard output. Default is False.

Returns :

histogram : ndarray

Number of points (or sum of weights) in each bin.

low_range : float

Lowest value of histogram, the lower limit of the first bin.

binsize : float

The size of the bins (all bins have the same size).

extrapoints : int

The number of points outside the range of the histogram.

See also

numpy.histogram

Notes

This histogram is based on numpy’s histogram but has a larger range by default if default limits is not set.