SamplingCount (FPScript)

21.09.2021

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%.

See Also

CompoundSamplingCount Function

MaximumValueCount Function

MeanValueCount Function

TimeAtLevelCount Function

Counting Procedures Option

Count Analysis Object

Share article or send as email:

You might be interested in these articles