MaximumValueCount (FPScript)
Carries out a maximum value count in accordance with the DIN 45667 standard.
Syntax
MaximumValueCount(Signal, ClassLimits, [ ReductionFactor = 1 ] [ , Normalize = 0 ])
The syntax of the MaximumValueCount function consists of the following parts:
Part |
Description |
|---|---|
Signal |
The signal to be studied. Permitted data structures are data series, 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 Signal. 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 the highest reduction factor value in each case is counted from the data set. For a ReductionFactor 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
MaximumValueCount({1, 9, 7, 5, 7, 6, 10, 2, 4, 2, 7}, (11., 0.5, 1), 1)
Results in Signal({1L, 2L, 0L, 1L, 1L, 1L, 3L, 0L, 1L, 1L}, (10, 1., 1.)) . Carries out a maximum value count. Ten classes are set with the class width of 1 starting at 0.5.
MaximumValueCount({1, 9, 7, 5, 7, 6, 10, 2, 4, 2, 7}, (11., 0.5, 1), 1, 100 %)
Carries out a maximum value count and normalizes the frequencies to 100 %.