User Tools

Site Tools


mean_mean_of_a_set_.htm
Navigation:  Templates > Guide to all Templates > Additional Libraries and Templates > Statistics Library >====== MEAN (mean of a set) ====== Previous pageReturn to chapter overviewNext page

MEAN(dataset)

blk2blue.jpg

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.

NoteBox.jpg

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

mean_mean_of_a_set_.htm.txt · Last modified: 2021/04/15 15:57 (external edit)