Data Series Operator (FPScript)
Forms a data series with linear ascending or descending values.
Syntax
(Number, StartingValue, Increment)
The syntax of the ( , , ) operator consists of the following elements:
Element |
Description |
|---|---|
Number |
Either the real numerical expression that determines the number of values for the data series and for which the value must then be greater than or equal to zero, or any non-scalar expression, such as a signal. In this case, Number is equal to the number of rows in the value passed. |
StartingValue |
A real numeric expression, a time span or a calendar time value for which the first value of the data series to be formed is determined. |
Increment |
A real numeric expression or time span that specifies the amount of the difference between the values of the data series. |
Remarks
The data type of the result is copied from one of the parameters StartingValue or Increment. The parameter with the highest resolution determines the data type of the result. If you specify the parameters as constants, their notation determines the data type of the result.
If Starting Value and Increment is a quantity, then they have to have the same SI dimension and the unit of Increment is transformed to the unit of StartingValue before creating the data series. If only one argument is a quantity, then the same unit is used for the other argument. If Number is a quantity, then it has to have the SI dimension 1 and it will be transformed to the unit 1 before multiplication.
Note: Use the Series function if you want to specify the data series above the starting value, end value or increment.
Available in
FlexPro View, Basic, Professional, Developer Suite
Examples
(100, 0., 0.1) |
Generates a data series with 100 64-bit floating point values starting with 0 and using the increment 0.1. |
(48, '1.1.2004', '00:30') |
Generates a data series with 48 calendar time values starting with '1/1/2004 00:00' and using 30 minute increments. |
(48, 0, -'00:30') |
Generates a data series with 48 time span values starting with '00:00:00' and using -30 minute increments. |
(NumberOfRows(Y), 0., 0.1) or (Y, 0., 0.1) |
Generates a data series for which the number of values corresponds to the data series stored in Y. |
(3, 0 V, 250 mV) |
Results in the data series { 0 V, 0.25 V, 0.5 V}. |
(2 Pi, 0, 1) |
Generates a data series with 6 values, since the unit Pi has the SI dimension 1 and 2 Pi transformed to the unit 1 results in 6.2831853 and is rounded to 6. |