### Navigation

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

# scipy.stats.mstats.hmean

`scipy.stats.mstats.``hmean`(a, axis=0)

  Calculates the harmonic mean along the specified axis.

  That is: n / (1/x1 + 1/x2 + ... + 1/xn)

  Parameters : | a : array_like Input array, masked array or object that can be converted to an array. axis : int, optional, default axis=0 Axis along which the harmonic mean is computed. dtype : dtype, optional Type of the returned array and of the accumulator in which the elements are summed. If dtype is not specified, it defaults to the dtype of a, unless a has an integer dtype with a precision less than that of the default platform integer. In that case, the default platform integer is used.
  Returns : | hmean : ndarray, see dtype parameter above

  See also

  `numpy.mean`
    Arithmetic average
  `numpy.average`
    Weighted average
  `gmean`
    Geometric mean

  Notes

  The harmonic mean is computed over a single dimension of the input array, axis=0 by default, or all values in the array if axis=None. float64 intermediate and return values are used for integer inputs.

  Use masked arrays to ignore any non-finite values in the input or that arise in the calculations such as Not a Number and infinity.

### Navigation

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