### Navigation

- index
- modules |
- modules |
- next |
- previous |
- SciPy v0.12 Reference Guide (DRAFT) »
- Statistical functions (`scipy.stats`) »

# 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.

### Navigation

- index
- modules |
- modules |
- next |
- previous |
- SciPy v0.12 Reference Guide (DRAFT) »
- Statistical functions (`scipy.stats`) »