- fastq-dump [options] < path/file > [< path/file > ...]
- fastq-dump [options] < accession >
Frequently Used Options
- Displays ALL options, general usage, and version information.
- Display the version of the program.
- Dump each read into separate file. Files will receive suffix corresponding to read number.
- Split spots into individual reads.
- FASTA only, no qualities. Optional line wrap width (set to zero for no wrapping).
- Append read id after spot id as 'accession.spot.readid' on defline.
- Defline contains only original sequence name.
- Formats sequence using color space (default for SOLiD). "cskey" may be specified for translation.
- Formats sequence using base space (default for other than SOLiD).
- Offset to use for ASCII quality scores. Default is 33 ("!").
- Minimum spot id to be dumped. Use with "X" to dump a range.
- Maximum spot id to be dumped. Use with "N" to dump a range.
- Filter by sequence length >= < len >
- Dump only biological reads.
- Dump only aligned sequences. Aligned datasets only; see sra-stat.
- Dump only unaligned sequences. Will dump all for unaligned datasets.
Workflow and piping
- Output directory, default is current working directory ('.').
- Output to stdout, all split data become joined into single stream.
- Compress output using gzip.
- Compress output using bzip2.
fastq-dump -X 5 -Z SRR390728
Prints the first five spots (-X 5) to standard out (-Z). This is a useful starting point for verifying other formatting options before dumping a whole file.
fastq-dump -I --split-files SRR390728
Produces two fastq files (--split-files) containing ".1" and ".2" read suffices (-I) for paired-end data.
fastq-dump --split-files --fasta 60 SRR390728
Produces two (--split-files) fasta files (--fasta) with 60 bases per line ("60" included after -- fasta).
fastq-dump --split-files --aligned -Q 64 SRR390728
Produces two fastq files (--split-files) that contain only aligned reads (--aligned; Note: only for files submitted as aligned data), with a quality offset of 64 (-Q 64) Please see the documentation on svdb-dump if you wish to produce fasta/qual data.
Possible errors and their solutions
fastq-dump.2.x err: item not found while constructing within virtual database module - the path '< path/SRR*.sra >' cannot be opened as database or table
This error indicates that the .sra file cannot be found. Confirm that the path to the file is correct.
fastq-dump.2.x err: name not found while resolving tree within virtual file system module - failed SRR*.sra
The data are likely reference compressed and the toolkit is unable to acquire the reference sequence(s) needed to extract the .sra file. Please confirm that you have tested and validated the configuration of the toolkit. If you have elected to prevent the toolkit from contacting NCBI, you will need to
manually acquire the reference(s) here