RangeCount (FPScript)

21.09.2021

Performs a range count from the Markov Matrix or a range pair count from the Rainflow Matrix. The function counts the absolute or cumulated frequencies of positive or negative ranges or range pairs (hystereses).

Syntax

RangeCount(Matrix, Result)

 

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

Part

Description

Matrix

The Markov or Rainflow matrix to be evaluated. If you specify a Markov matrix, the result will be the ranges. With a Rainflow matrix, you obtain the range pairs. The matrix can be specified as a data matrix or as a signal series with a Z component. In the second case, the X and Y components must contain the midpoints of the class division that the matrix is based on.

Permitted data structures are data matrix und signal series. All real data types are permitted.

For the X component additional restrictions do apply.The values must have a constant non-zero spacing.

If the argument is a list, then the function is executed for each element of the list and the result is also a list.

Result

Specifies whether positive or negative ranges are to be counted and whether cumulated frequencies are to be determined.

The argument Result can have the following values:

Constant

Meaning

COUNT_MINUS

The negative ranges or range pairs are counted.

COUNT_PLUS

The positive ranges or range pairs are counted.

+ COUNT_CUMULATIVE

This constant can be added as an option and then specifies that the cumulated frequencies are to be determined.

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.

Remarks

If cumulated frequencies are required, for positive ranges, the frequencies of the respective class and all higher classes are totaled; for negative ranges, all of the lower classes are totaled accordingly. If the Matrix was passed as a signal series, the result is a signal whose X component contains the ranges reconstructed from the class midpoints from the Matrix. Otherwise, the result is a data series.

When reconstructing the ranges, an equidistant class division is assumed.

Available in

Option Counting Procedures

Examples

RangeCount(MarkovMatrix, COUNT_PLUS)

Counts the positive ranges of the Markov matrix determined with the MarkovMatrix function.

RangeCount(RainflowMatrix, COUNT_MINUS)

Counts the negative range pairs of the Rainflow matrix determined with the RainflowMatrix function.

See Also

LevelCrossingCount Function

MarkovMatrix Function

RainflowMatrix Function

PeakCount Function

Counting Procedures Option

Rainflow Count Analysis Object

Share article or send as email:

You might be interested in these articles