| Navigation: Templates > Guide to all Templates > Additional Libraries and Templates > Statistics Library >====== MEAN (mean of a set) ====== |    |
MEAN(dataset)
| MEAN | Returns the mean or average of a set of numbers. |
| dataset | The label of a QUEUE with its first component field defined as a REAL. |
MEAN computes the arithmetic average of a set. The arithmetic average is the sum of a set's values divided by the number of elements in the set. The function operates on the numeric set defined by all the entries in the first component of the designated QUEUE (dataset).
For example, if the set contains 5 values: [1,2,3,4,5] then the mean is (1+2+3+4+5) / 5 = 3.
The passed data set does not have to be sorted. The function copies the passed set. The passed data set is unchanged.
Return DataType: REAL
Example:
StatSetX QUEUE,PRE()
X REAL
END
MeanOfSet REAL
CODE
FREE(StatSetX) !free the QUEUE
CLEAR(STADAT:RECORD) !clear the record buffer
STADAT:Id = STA:Id !prime the record buffer
STADAT:ItemNumber = 1
SET(STADAT:KeyIdItemNumber,STADAT:KeyIdItemNumber !position file pointer
LOOP !load the QUEUE
NEXT(StatisticsData) !read next record
IF ERRORCODE() OR STADAT:Id NOT = STA:Id
BREAK
ELSE
StatSetX:X = STADAT:X !load the QUEUE buffer
ADD(StatSetX) !add to the QUEUE
END
END
MeanOfSet = MEAN(StatSetX) !call MEAN