mirror of
https://github.com/lcn2/calc.git
synced 2025-08-16 01:03:29 +03:00
73 lines
2.2 KiB
Plaintext
73 lines
2.2 KiB
Plaintext
NAME
|
|
avg - average (arithmetic) mean of values
|
|
|
|
SYNOPSIS
|
|
avg(x_1, x_2, ...)
|
|
|
|
TYPES
|
|
x_1, ... arithmetic or list
|
|
|
|
return as determined by types of items averaged
|
|
|
|
DESCRIPTION
|
|
If there are n non-list arguments x_1, x_2, ..., x_n,
|
|
for which the required additions and division by n are defined,
|
|
avg(x_1, x_2, ..., x_n) returns the value of:
|
|
|
|
(x_1 + x_2 + ... + x_n)/n.
|
|
|
|
If the x_i are real, the result will be a real number; if the
|
|
x_i are real or complex numbers, the result will be a real or complex
|
|
number. If the x_i are summable matrices the result will be a matrix
|
|
of the same size (e.g. if the x_i are all 3 x 4 matrices with real
|
|
entries, the result will be a 3 x 4 matrix with real entries).
|
|
|
|
If an argument x_i is list-valued, e.g. list(y_1, y_2, ...), this
|
|
is treated as contributing y_1, y_2, ... to the list of items to
|
|
be averaged.
|
|
|
|
EXAMPLE
|
|
; print avg(1,2,3,4,5), avg(list(1,2,3,4,5)), avg(1,2,list(3,4,5))
|
|
3 3 3
|
|
|
|
; mat x[2,2] = {1,2,3,4}
|
|
; mat y[2,2] = {1,2,4,8}
|
|
; avg(x,y)
|
|
|
|
mat [2,2] (4 elements, 4 nonzero):
|
|
[0,0] = 1
|
|
[0,1] = 2
|
|
[1,0] = 3.5
|
|
[1,1] = 6
|
|
|
|
LIMITS
|
|
The number of arguments is not to exceed 1024.
|
|
|
|
LINK LIBRARY
|
|
none
|
|
|
|
SEE ALSO
|
|
hmean
|
|
|
|
## Copyright (C) 1999-2006,2021 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.
|
|
## 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
##
|
|
## Under source code control: 1994/09/25 20:22:31
|
|
## File existed as early as: 1994
|
|
##
|
|
## chongo <was here> /\oo/\ http://www.isthe.com/chongo/
|
|
## Share and enjoy! :-) http://www.isthe.com/chongo/tech/comp/calc/
|