Version: 1.0
Overview
Certain processing protocols require a subset of the elements of a list. This application will generate the sublist given a data list and a filter list. The data and filter may be delimited by spaces or new-lines, and they must have the same number of elements. The data may have any ascii tokens. The filter must have only two tokens, the "pass" and "stop" tokens. These tokens are user definable.
Usage Summary
The data list may be read from file or standard input. The filter list must be specified by a file. The user may define the filter "pass" and "stop" tokens used in the filter list with the appropriate command line flags. The output list may be written to a file or standard output. If the verbose application mode is enabled, then standard output is not allowed for the output list.
| Argument | Type | Required | Description | Notes |
|---|
| -overwrite | flag | No | Enables file overwriting | |
| -debug | flag | No | Enables additional error reporting | |
| -input | File | No | Used to specify the input filename. If not present, standard input is used. | |
| -filter | File | Yes | Used to specify the filter filename. | |
| -and | File | No | Used to specify the filter filename that will be logically and-ed with with the provided filter. | |
| -pass | String | No | Used to specify filter pass value. Default: Pass | |
| -stop | String | No | Used to specify filter stop value. Default: Stop | |
| -output | File | No | Used to specify the output filename. If not present, standard output is used. | |
| -help | flag | No | Prints help and usage information. | |
| -version | flag | No | Prints version number of this application. | |
| -verbose | flag | No | Enables detailed status messages. | |
| -license | flag | No | Prints license details, and exits. | |
| -twiki | flag | No | Writes command line arguments as a TWiki format table to output and exit. | |
| -pipeline | flag | No | Write pipeline descriptor file to output and exit. | |
| -pipelineJar | String | No | Specify path to an application jar file, as a pipeline resource. | Example: "pipeline://localhost//home/zed/Connery.jar" |
| -pipelineJvm | String | No | Specify a Java Virtual Machine called by a pipeline. | |
| -pipelineJvmOptions | String | No | Specify Java Virtual Machine options used by a pipeline. | |
Examples
Suppose we have the data list 'data.list':
fileA.suf
fileB.suf
fileC.suf
fileD.suf
fileE.suf
and the filter list 'filter.list':
True
False
False
True
True
The following call would apply the filter to the data:
java -jar ListFilter -input data.list -filter filter.list -pass True -stop False -output filtered_data.list
The output list is 'filtered_data.list':
fileA.suf
fileD.suf
fileE.suf
