RemoveVoidValues (FPScript)
Removes void values from a data set.
Syntax
RemoveVoidValues(DataSet)
or
RemoveVoidValues(Y, X)
or
RemoveVoidValues(Y, X, Z)
The syntax of the RemoveVoidValues function consists of the following parts:
Part |
Description |
|---|---|
DataSet |
The data set from which void points are to be removed. A missing X or Z component is automatically generated as a linear series, so that even in a data series or data matrix it is possible to identify which values, or rows or columns have been removed. All data structures are allowed, except scalar value. All numeric data types are permitted. If the argument is a list, then the function is executed for each element of the list and the result is also a list. |
Y |
The Y component of the data set to be processed. If you specify a composite data structure, its Y component is used. Permitted data structures are data series, data matrix, signal, signal series und signal series with two-dimensional X-component. All numeric data types are permitted. 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. |
X |
The X component of the data set to be processed. If you specify a composite data structure, its Y component is used. Permitted data structures are data series, data matrix, signal, signal series und signal series with two-dimensional X-component. All numeric data types are permitted. 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. |
Z |
The Z component of the data set to be processed. If you specify a composite data structure, its Y component is used. Permitted data structures are data series und signal. All numeric data types are permitted. 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
A complex value is considered void if its real part or imaginary part is void. A point in a signal is assumed to be void if its Y or X component is void. A point in a space curve is assumed to be void if its X or Z component is void. A row in a signal series is assumed to be void if its X value or all Y values are void. A column in a signal series is assumed to be void if its Z value or all Y values are void. In a signal series with a two-dimensional X component, a row or column is assumed to be void if at least one of the components is void for all XY value pairs. In the case of two-dimensional data sets, void values may therefore remain in the result. If you want to remove all void values from a signal series, you have to delete the signal series before converting the void values into a list using the SeriesToList function.
Available in
FlexPro Basic, Professional, Developer Suite
Examples
RemoveVoidValues(Signal) |
Removes void values from the signal. |
RemoveVoidValues(SeriesToList(SignalSeries)) |
Removes all void values from the signal series and returns a list of potentially different length signals. |