harmmean (Statistics Toolbox)

Harmonic mean of a sample of data.

Syntax

m = harmmean(X)

Description

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

The harmonic mean is:

Examples

The sample average 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