CompoundMaximumValueCount (FPScript)

21.09.2021

Performs a maximum value count in accordance with the DIN 45667 standard synchronously for two signals.

Syntax

CompoundMaximumValueCount(Signal1, Signal2, ClassLimits1, ClassLimits2, [ ReductionFactor = 1 ] [ , Normalize = 0 ])

 

The syntax of the CompoundMaximumValueCount function consists of the following parts:

Part

Description

Signal1

The first signal to be examined.

Permitted data structures are data series und signal. 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.

Signal2

The second signal to be examined.

Permitted data structures are data series und signal. 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.

ClassLimits1

Contains a data series, which contains the class limits for the first signal. If ClassLimits1 contains n values, this leads to n-1 closed classes. The first or the last value in ClassLimits1 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 Signal1.

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.

ClassLimits2

Contains a data series, which contains the class limits for the second signal.

Permitted data structures are data series. All real data types are permitted. The unit has to be compatible with that of parameter Signal2.

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 of ReductionFactor values in each case is counted from the data set. For a reduction factor 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 series with a Z component with the absolute or normalized frequencies in the Y component. The X component or Z component then contains the mid-points of the class divisions specified as the arguments ClassLimits1 or ClassLimits2 respectively.

Absolute frequencies are returned as 64-bit integers and normalized frequencies as floating point values.

Available in

Option Counting Procedures

Examples

CompoundMaximumValueCount(Signal1, Signal2, (11., 0.5, 1), (11., 0.5, 1), 2)

Performs a maximum value count for the two signals 'Signal1' and 'Signal2'. The maxima from two values per signal are searched for and then counted. The result are absolute frequencies with 10 classes for both signals.

CompoundMaximumValueCount(Signal1, Signal2, (11., 0.5, 1), (11., 0.5, 1), 2, 100 %)

Carries out a maximum value count and normalizes the frequencies to 100 %.

See Also

CompoundSamplingCount Function

CompoundTimeAtLevelCount Function

MaximumValueCount Function

Counting Procedures Option

Compound Count Analysis Object

Share article or send as email:

You might be interested in these articles