NAME
    hmean - harmonic mean of a number of values

SYNOPSIS
    hmean(x_1, x_2, ...)

TYPES
    x_1, ...	arithmetic or list

    return	determined by types of arguments, or null

DESCRIPTION
    The null value is returned if there are no arguments.

    If there are n non-list arguments x_1, x_2, ... and the
    required operations are defined, hmean(x_1, x_2, ...) returns the
    value of:

	n/(inverse(x_1) + inverse(x_2) + ... + inverse(x_n)).

    If an argument x_i is a list as defined by list(y_1, ..., y_m)
    this is treated as if in (x_1, x_2, ...), x_i is replaced by
    y_1, ..., y_m.


EXAMPLE
    ; c = config("mode", "frac")
    ; print hmean(1), hmean(1,2), hmean(1,2,3), hmean(1,2,3,4), hmean(1,2,0,3)
    1 4/3 18/11 48/25 0

LIMITS
    The number of arguments is not to exceed 1024.

LINK LIBRARY
    none

SEE ALSO
    avg

## Copyright (C) 1999-2006  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 59 Temple Place, Suite 330, Boston, MA  02111-1307, USA.
##
## @(#) $Revision: 29.4 $
## @(#) $Id: hmean,v 29.4 2006/06/22 23:49:22 chongo Exp $
## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/hmean,v $
##
## Under source code control:	1995/12/18 03:30:59
## File existed as early as:	1995
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/
