# harmonic_mean: Harmonic Mean In umx: Structural Equation Modeling and Twin Modeling in R

 harmonic_mean R Documentation

## Harmonic Mean

### Description

The harmonic mean is the reciprocal of the arithmetic mean of the reciprocals of the input values. Common uses include computing the mean of ratios, for instance the average P/E ratio in a portfolio. Also it is the correct mean for averaging speeds weighted for distance.

### Usage

```harmonic_mean(x, weights = NULL, na.rm = c(TRUE, FALSE))
```

### Arguments

 `x` A vector of values to take the harmonic mean for `weights` Optional vector of weights. `na.rm` remove NAs (default = TRUE).

### Value

• Harmonic mean of x

### References

Other Miscellaneous Stats Functions: `FishersMethod()`, `SE_from_p()`, `geometric_mean()`, `oddsratio()`, `reliability()`, `umxCov2cor()`, `umxHetCor()`, `umxParan()`, `umxWeightedAIC()`, `umx_apply()`, `umx_cor()`, `umx_means()`, `umx_r_test()`, `umx_round()`, `umx_scale()`, `umx_var()`, `umx`

### Examples

```# Harmonic means are suitable for ratios
tmp = c(33/1, 23/1)
harmonic_mean(tmp)

geometric_mean(tmp)
mean(tmp)

# Example with weights
harmonic_mean(c(33/1, 23/1), weights= c(.2, .8))
# If Jack travels outbound at 1 mph, and returns at 10 miles an hour, what is his average speed?
harmonic_mean(c(1,10)) # 1.81 mph

```

umx documentation built on Sept. 21, 2022, 9:07 a.m.