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

scipy.stats.mode

scipy.stats.mode(a, axis=0)

Returns an array of the modal (most common) value in the passed array.

If there is more than one such value, only the first is returned. The bin-count for the modal bins is also returned.

Parameters :

a : array_like

n-dimensional array of which to find mode(s).

axis : int, optional

Axis along which to operate. Default is 0, i.e. the first axis.

Returns :

vals : ndarray

Array of modal values.

counts : ndarray

Array of counts for each mode.

Examples

>>> a = np.array([[6, 8, 3, 0],
                  [3, 2, 1, 7],
                  [8, 1, 8, 4],
                  [5, 3, 0, 5],
                  [4, 7, 5, 9]])
>>> from scipy import stats
>>> stats.mode(a)
(array([[ 3.,  1.,  0.,  0.]]), array([[ 1.,  1.,  1.,  1.]]))

To get mode of whole array, specify axis=None:

>>> stats.mode(a, axis=None)
(array([ 3.]), array([ 3.]))