help/avg

   1 NAME
   2     avg - average (arithmetic) mean of values
   3
   4 SYNOPSIS
   5     avg(x_1, x_2, ...)
   6
   7 TYPES
   8     x_1, ...    arithmetic or list
   9
  10     return      as determined by types of items averaged
  11
  12 DESCRIPTION
  13     If there are n non-list arguments x_1, x_2, ..., x_n,
  14     for which the required additions and division by n are defined,
  15     avg(x_1, x_2, ..., x_n) returns the value of:
  16
  17         (x_1 + x_2 + ... + x_n)/n.
  18
  19     If the x_i are real, the result will be a real number; if the
  20     x_i are real or complex numbers, the result will be a real or complex
  21     number.  If the x_i are summable matrices the result will be a matrix
  22     of the same size (e.g. if the x_i are all 3 x 4 matrices with real
  23     entries, the result will be a 3 x 4 matrix with real entries).
  24
  25     If an argument x_i is list-valued, e.g. list(y_1, y_2, ...), this
  26     is treated as contributing y_1, y_2, ... to the list of items to
  27     be averaged.
  28
  29 EXAMPLE
  30     > print avg(1,2,3,4,5), avg(list(1,2,3,4,5)), avg(1,2,list(3,4,5))
  31     3 3 3
  32
  33     > mat x[2,2] = {1,2,3,4}
  34     > mat y[2,2] = {1,2,4,8}
  35     > avg(x,y)
  36
  37     mat [2,2] (4 elements, 4 nonzero):
  38       [0,0] = 1
  39       [0,1] = 2
  40       [1,0] = 3.5
  41       [1,1] = 6
  42
  43 LIMITS
  44    The number of arguments is not to exceed 100.
  45
  46 LINK LIBRARY
  47     none
  48
  49 SEE ALSO
  50     hmean
  51