### Navigation

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

# scipy.stats.mstats.mode

`scipy.stats.mstats.``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.]))

### Navigation

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