auto_SetFilterΒΆ
auto_SetFilter sets a filter to filter data records.
- bool = auto_SetFilter(ssFilter)
- bool = auto_SetFilter(ssFilter, ssNCName)
- bool = auto_SetFilter(ssFilter, ncid)
Return Value
bool
Parameters
- ssFilter
ssFilter is a scalar string that specifies the record filter. The filter can consist of up to seven AND (
&&) or OR (||) connected comparisons. Each consists of a channelname enclosed in $ characters, followed by an operator, followed by a value. The operator must be enclosed in spaces. Channel names may contain the following special characters:.,-,+,$,#,~,!,^,&,%. The special characters must be replaced by underscores. See example.The following operators are available:
Operator
Meaning
Channelname < Value
True if Channelname is less than Value.
Channelname <= Value
True if Channelname is less than or equal to Value.
Channelname == Value
True if Channelname is equal to Value. For the equal operator a tolerance can be specified as an absolut value or in percent. The tolerance must be enclosed in round braces. See example.
Channelname != Value
True if Channelname is not equal to Value.
Channelname > Value
True if Channelname is greater than Value.
Channelname >= Value
True if Channelname is greater or equal to Value.
The channel must be a real or a string vector. For text channels the wildcards
*and?can be used. The asterisk character (*) substitutes for zero or more characters. The question mark (?) substitutes for exactly one character. Example:auto_SetFilter("$Mode$ == On*")
Insert a space between each element.
If the search text contains spaces the string must be enclosed in quotest with leading backslashes:
auto_SetFilter("$Mode$ == \"a b\"")
An empty filter string disables the record filter. The NC file name must be specified:
auto_SetFilter("", "d:/test.nc2")
- ssNCName
ssNCName is the complete name of an NC-Data file. This parameter is optional, if the
auto_ImportData()has been called beforeauto_SetFilter.
- ncid
Identifies the netCDF file.
Example
svFile = GetRootDirectory() + "samples/vollast.asc";
svFile[1] = auto_ImportData(svFile[1]);
auto_SetFilter("$N$ > 1000 && $N$ < 5000 && $MEFF$ >= 100");
auto_ImportData(svFile[1]);
auto_SetFilter("$N$ == 1000(0.5%)"); // Tolerance +- 0.5 % of 1000
auto_ImportData(svFile[1]);
auto_SetFilter("$N$ == 1000(5)"); // Tolerance +-5 rpm
History
Version |
Description |
|---|---|
R2013.10 |
Parameter ncid added. Error with string channels corrected. |
R2013.3 |
Filer can contain string channels. |
id-1372812