Increment (FPScript)
Determines the increment of a data set or of its X component with linearly increasing or decreasing values.
Syntax
Increment(DataSet)
The syntax of the Increment function consists of the following parts:
Part |
Description |
|---|---|
DataSet |
The data set for which the increment is determined. All data structures are allowed, except scalar value und list. Not supported data types arestring. |
Remarks
As the result the function returns a scalar value of data type 64-bit floating point.
The result has the same unit as the argument DataSet.
For signals, signal series and space curves, only the X component is analyzed. The increment corresponds to the difference of consecutive values in the data set. The increments between neighboring values do not, however, have to be exactly the same, but may deviate by a maximum of 1 %. If this tolerance band is exceeded, the data set does not contain at least two values, or it contains void values, then a void floating point value is passed. Otherwise, the increment between the first and second value is passed.
If the argument is a list, then the function is executed for each element of the list and the result is also a list.
For complex data types the absolute value is formed.
Available in
FlexPro View, Basic, Professional, Developer Suite
Examples
Increment({1, 3, 5}) |
Results in 2. |
Increment({1, 2.001, 3}) |
Results in 1.001. |
Increment({1, 2, 3.001}) |
Results in 1. |
Increment({1, 2.1, 3}) |
Results in ?. |
Increment({1, 2, ?, 4}) |
Results in ?. |
Increment((10, 0 Hz, 0.5 Hz)) |
Results in 0.5 Hz. |
Increment(Signal({1 V, 1.5 V }, 0.5 ms)) |
Results in 0.5 ms. |