SamplingCount (FPScript)
Performs a sampling count in accordance with the DIN 45667 standard.
Syntax
SamplingCount(DataSet, ClassLimits, [ ReductionFactor = 1 ] [ , Normalize = 0 ])
The syntax of the SamplingCount function consists of the following parts:
Part |
Description |
|---|---|
DataSet |
The data set to be examined. Permitted data structures are data series, data matrix, signal, signal series und signal series with two-dimensional X-component. All real data types are permitted. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
ClassLimits |
Contains a data series, which contains the class limits for the count. If ClassLimits contains n values, this leads to n-1 closed classes. The first or the last value in ClassLimits provides the lowest or highest limit of the class division. Values that lie outside the limits are not counted. Permitted data structures are data series. All real data types are permitted. The unit has to be compatible with that of parameter DataSet. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. |
ReductionFactor |
Specifies a reduction factor. Only every nth value is counted. For n is greater than one, you could lose information, since not all measurement values are counted! Permitted data structures are scalar value. All integral data types are permitted. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. If this argument is omitted, it will be set to the default value 1. |
Normalize |
Specifies a value to which the frequencies are to be normalized. If you specify 0 here, no normalization occurs, and the function provides the absolute frequencies. Permitted data structures are scalar value. All real data types are permitted. If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated. If this argument is omitted, it will be set to the default value 0. |
Remarks
Void values are not counted. The result is a signal or a signal series with the absolute or normalized frequencies in the Y component. The X component then contains the mid-points of the class divisions specified as the argument ClassLimits.
Absolute frequencies are returned as 64-bit integers and normalized frequencies as floating point figures.
Available in
Option Counting Procedures
Examples
SamplingCount({1, 9, 7, 5, 7, 6, 10, 2, 4, 2, 7}, (11., 0.5, 1), 2)
Results in Signal({1L, 0L, 0L, 1L, 0L, 0L, 3L, 0L, 0L, 1L}, (10,1.,1.)). Carries out a sampling count. Ten classes are set with the class width of 1 starting at 0.5. However, only every second value is counted, which means the data series {1, 7, 7, 10, 4, 7} is counted.
SamplingCount({1, 9, 7, 5, 7, 6, 10, 2, 4, 2, 7}, (11., 0.5, 1), 2, 100 %)
Carries out a sampling count and normalizes the frequencies to 100%.