# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

# harmmean

Harmonic mean

## Syntax

```m = harmmean(X) harmmean(X,dim) ```

## Description

`m = harmmean(X)` calculates the harmonic mean of a sample. For vectors, `harmmean(x)` is the harmonic mean of the elements in `x`. For matrices, `harmmean(X)` is a row vector containing the harmonic means of each column. For N-dimensional arrays, `harmmean` operates along the first nonsingleton dimension of `X`.

`harmmean(X,dim)` takes the harmonic mean along dimension `dim` of `X`.

The harmonic mean is

`$m=\frac{n}{\sum _{i=1}^{n}\frac{1}{{x}_{i}}}$`

## Examples

The arithmetic mean is greater than or equal to the harmonic mean.

```x = exprnd(1,10,6); harmonic = harmmean(x) harmonic = 0.3382 0.3200 0.3710 0.0540 0.4936 0.0907 average = mean(x) average = 1.3509 1.1583 0.9741 0.5319 1.0088 0.8122```