@@ -47,5 +47,63 @@ fqgrep -r 'GACGAGATTA' -a 'GACGTGATTA' --r1-fastq /data/testR1.fastq.gz --r2-fa
4747See the following for usage:
4848
4949``` console
50- fqgrep -h
50+ $ fqgrep -h
51+ fqgrep 1.0.3
52+ The fqgrep utility searches any given input FASTQ files, selecting records whose bases match one or more patterns. By
53+ default, a pattern matches the bases in a FASTQ record if the regular expression (RE) in the pattern matches the bases.
54+ An empty expression matches every line. Each FASTQ record that matches at least one of the patterns is written to the
55+ standard output.
56+
57+ INPUT COMPRESSION
58+
59+ By default, the input files are assumed to be uncompressed with the following exceptions: (1) If the input files are
60+ real files and end with `.gz` or `.bgz`, they are assumed to be GZIP compressed, or (2) if they end with `.fastq` or
61+ `.fq`, they are assumed to be uncompressed, or (3) if the `-Z/--decompress` option is specified then any unrecongized
62+ inputs (including standard input) are assumed to be GZIP compressed.
63+
64+ THREADS
65+
66+ The `--threads` option controls the number of threads used to _search_ the reads. Independently, for single end reads or
67+ interleaved paired end reads, a single thread will be used to read each input FASTQ. For paired end reads across pairs
68+ of FASTQs, two threads will be used to read the FASTQs for each end of a pair. Finally, a single thread will be created
69+ for the writer.
70+
71+ EXIT STATUS
72+
73+ The fqgrep utility exits with one of the following values: 0 if one or more lines were selected, 1 if no lines were
74+ selected, and >1 if an error occurred.
75+
76+ USAGE:
77+ fqgrep [FLAGS] [OPTIONS] [--] [args]...
78+
79+ FLAGS:
80+ -c, --count Only a count of selected lines is written to standard output
81+ -F, --fixed-strings Interpret pattern as a set of fixed strings
82+ -v Selected lines are those not matching any of the specified patterns
83+ -Z, --decompress Assume all unrecognized inputs are GZIP compressed
84+ --paired Treat the input files as paired. The number of input files must be a multiple of two,
85+ with the first file being R1, second R2, third R1, fourth R2, and so on. If the pattern
86+ matches either R1 or R2, then both R1 and R2 will be output (interleaved). If the input
87+ is standard input, then treat the input as interlaved paired end reads
88+ --reverse-complement Search the reverse complement for matches
89+ --progress Write progress information
90+ -h, --help Prints help information
91+ -V, --version Prints version information
92+
93+ OPTIONS:
94+ -t, --threads <threads> The number of threads to use for matching reads against pattern. See the full usage for
95+ threads specific to reading and writing [default: 12]
96+ --color <color> Mark up the matching text. The possible values of when are “never”, “always” and “auto”
97+ [default: never]
98+ -e, --regexp <regexp>... Specify a pattern used during the search of the input: an input line is selected if it
99+ matches any of the specified patterns. This option is most useful when multiple `-e`
100+ options are used to specify multiple patterns
101+ -f, --file <file> Read one or more newline separated patterns from file. Empty pattern lines match every
102+ input line. Newlines are not considered part of a pattern. If file is empty, nothing
103+ is matched
104+
105+ ARGS:
106+ <args>... The first argument is the pattern to match, with the remaining arguments containing the files to
107+ match. If `-e` is given, then all the arguments are files to match. Use standard input if either
108+ no files are given or `-` is given
51109```
0 commit comments