| Navigation: Templates > Guide to all Templates > Additional Libraries and Templates > Statistics Library >====== FREQUENCY (frequency count of an item in a set) ====== |    |
FREQUENCY(dataset,searchvalue)
| FREQUENCY | Counts the number of instances of a particular value within a numeric set. |
| dataset | The label of a QUEUE with its first component field defined as a REAL. |
| searchvalue | A numeric constant or variable containing the value to search for in the QUEUE. |
FREQUENCY counts the number of instances of a particular value (searchvalue) within a numeric set (dataset). The function operates on the numeric set defined by all the entries in the first component of the designated QUEUE (dataset).
For example, given the data set: [1,2,2,3,4,5] and the search value 2, the function would return a frequency count of 2.
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
FrequencyOfX REAL
SearchValue REAL(1)
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
FrequencyOfX = FREQUENCY(StatSetX,SearchValue) !call FREQUENCY to search Q