ValuesInInterval (FPScript)
Searches a data set for values that lie in a particular interval, or searches for void values.
Syntax
ValuesInInterval(DataSet, LowerLimit, UpperLimit, [ Operation = EVENT_DEFAULT ], [ DeltaXmin ] [ , DeltaXmax ])
The syntax of the ValuesInInterval function consists of the following parts:
Part |
Description |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
The data set to be searched. Permitted data structures are data series, data matrix, signal und signal series. All numeric data types are permitted. For complex data types the absolute value is formed. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
||||||||||||
LowerLimit |
Specifies the lower limit of the interval in which the values must lie. Values that are exactly on the limit are also found. Permitted data structures are scalar value. All numeric data types are permitted. The unit has to be compatible with that of parameter DataSet. For complex data types the absolute value is formed. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
||||||||||||
UpperLimit |
Specifies the upper limit of the interval in which the values must lie. Values that are exactly on the limit are also found. Permitted data structures are scalar value. All numeric data types are permitted. The unit has to be compatible with that of parameter DataSet. For complex data types the absolute value is formed. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
||||||||||||
Operation |
Specifies the way the function operates. The argument Operation 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. If this argument is omitted, it will be set to the default value EVENT_DEFAULT. |
||||||||||||
DeltaXmin |
Optionally determines the minimum duration or number of values that an event must endure to be valid. If you search within a signal, this is the X range from the first value of the event to the last value of the event. If you search within a data series, this is the minimum number of data points that the event must have. Permitted data structures are scalar value. All numeric data types are permitted. The unit has to be compatible with that of parameter DataSet. For complex data types the absolute value is formed. 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. |
||||||||||||
DeltaXmax |
Optionally determines the maximum duration or number of values that an event can endure to be valid. If you search within a signal, this is the X range from the first value of the event to the last value of the event. If you search within a data series, this is the maximum number of data points that the event can have. Permitted data structures are scalar value. All numeric data types are permitted. The unit has to be compatible with that of parameter DataSet. For complex data types the absolute value is formed. 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 you want to search for a specific value, you must specify this as the upper and lower limit. You can search for void values by setting the LowerLimit and UpperLimit to void.
Available in
FlexPro View, Basic, Professional, Developer Suite
Examples
ValuesInInterval({1, 5, 7, 4, 3}, 4, 5) |
Results in {1L, 3L}. Results in the indices of the values that lie in the interval [4, 5]. |
ValuesInInterval({1, ?, 7, ?, 3}, ?, ?) |
Results in {1L, 3L}. Results in the indices of the void values. |
ValuesInInterval(Signal, 5.5, 5.5) |
Searches the signal for all occurrences of the Y value 5.5. |
ValuesInInterval({1,2,3,3,4,4}, 2, 3, EVENT_INDEX, 2 , 3) |
Results in {1L, 2L, 3L}. Results in the indices of the values that lie in the interval [2, 3]. There must be at least two and not more than 3 neighboring values of the event. |