Skip to content

Commit b70b66f

Browse files
authored
Update README.md (#43)
1 parent f4c4050 commit b70b66f

File tree

1 file changed

+59
-1
lines changed

1 file changed

+59
-1
lines changed

README.md

Lines changed: 59 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,5 +47,63 @@ fqgrep -r 'GACGAGATTA' -a 'GACGTGATTA' --r1-fastq /data/testR1.fastq.gz --r2-fa
4747
See 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

Comments
 (0)