RangeCount (FPScript)
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:
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. |