| **Navigation:**  [[templates.htm|Templates]] > Guide to all Templates > [[additional libraries and templates.htm|Additional Libraries and Templates]] > Statistics Library >====== MEAN (mean of a set) ====== | [[lowerquartile  lower quartile value of a set .htm|{{btn_prev_n.gif|Previous page}}]][[additional libraries and templates.htm|{{btn_home_n.gif|Return to chapter overview}}]][[median  median of a set .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**MEAN**(dataset)

{{blk2blue.jpg|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|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**