harmonicMean

returns the harmonic mean of a list of numbers.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 6.1 Security:

# Syntax

harmonicMean(numbersList)

# Params

- numbersList : A comma-separated list of numbers, or an expression that evaluates to such a list, or an array containing only numbers.

# Examples

harmonicMean(4,36,45,50,75) -- returns 15

put harmonicMean(importedList) into field "Harmonic Mean"

# Description

Use the harmonicMean function to find the value that best represents a group of values for sets of numbers which are defined in relation to some unit.

The harmonicMean function was added in version 6.1 to complement the average function.

If the numbersList is empty, the harmonicMean function returns zero.

If a math operation on finite inputs produces a non-finite output, an execution error is thrown. See math operations for more information.

# Tags

# See

- **control structure:** function - **glossary:** return, value, math operation - **function:** min, geometricMean, statRound, variance, round, average, value, max, median, standardDeviation