1# The NCBI SRA (Sequence Read Archive)
2
3### Contact:
4email: sra@ncbi.nlm.nih.gov
5
6### Download
7Visit our [download page](https://github.com/ncbi/sra-tools/wiki/01.-Downloading-SRA-Toolkit) for pre-built binaries.
8
9### Change Log
10Please check the CHANGES.md file for change history.
11
12## The SRA Toolkit
13The SRA Toolkit and SDK from NCBI is a collection of tools and libraries for
14using data in the INSDC Sequence Read Archives.
15
16### ANNOUNCEMENT:
17NIH has released a request for information (RFI) to solicit community feedback on new proposed Sequence Read Archive (SRA) data formats. Learn more and share your thoughts at https://go.usa.gov/xvhdr. The response deadline is July 17th, 2020. We’d encourage you all to share with your colleagues and networks, and respond if you are an SRA submitter or data user.
18
19SRA Toolkit 2.11.0 March 15, 2021
20
21  **fasterq-dump**: does not exit with 0 any more if the given path is not found
22  **fasterq-dump**: does not exit with 0 if accession is not found
23  **fasterq-dump**: does not fail when requested to dump a run file with non-standard name
24  **fasterq-dump**: available on windows
25  **kfg, prefetch, vfs**: resolve WGS reference sequences into "Accession Directory"
26  **kfg, sra-tools, vfs**: dropped support of protected repositories
27  **kns, sra-tools**: fixed formatting of HTTP requests for proxy
28  **ncbi-vdb, ngs, ngs-tools, sra-tools, vdb**: added support for 64-bit ARM (AArch64, Apple Silicon)
29  **prefetch, vfs**: fixed download of protected non-run files
30  **prefetch, vfs**: fixed segfault during download of JWT cart
31  **prefetch, vfs**: respect requested version when downloading WGS files
32  **sra-pileup**: now silent if requested slice has no alignments or reference-name does not exist
33  **sratools**: added description and documentation of the sratools driver tool to GitHub wiki
34  **sra-tools**: created a script to fix names of downloaded sra files
35  **sra-tools**: created a script to move downloaded sra run files into proper directories
36  **sratools**: disable-multithreading option removed from help text for tools that do not support it
37  **sratools**: does not access remote repository when it is disabled
38  **sra-tools, vfs**: recognize sra file names with version
39  **vdb-dump**: exits with no-zero value if asked for non existing column
40
41SRA Toolkit 2.10.8
42
43kproc, fasterq-dump: fixed problem with seg-faults caused by too small stack used by threads
44kdbmeta: allow to work with remote runs
45kdb, vdb, vfs, sra-tools: fixed bug preventing use of path to directory created by prefetch if it ends with '/'
46vfs, sra-tools, ngs-tools: report an error when file was encrypted for a different ngc file
47prefetch: print error message when cannot resolve reference sequence
48vfs, prefetch: download encrypted phenotype files with encrypted extension
49vdb, sra-docker: config can auto-generate LIBS/GUID when in a docker container
50
51SRA Toolkit 2.10.5
52sratools: fixed a potential build problem in libutf8proc
53ncbi-vdb, ngs, ngs-tools, sra-tools: all Linux builds now use g++ 7.3 (C++11 ABI)
54prefetch: improvements were made to work in environments with bad network connections
55prefetch, sratools: fixed the names of the --min-size and --max-size command line arguments when running prefetch
56
57SRA Toolkit 2.10.4
58kns, sra-tools:: fixed errors when using ngc file
59
60SRA Toolkit 2.10.3
61sraxf, fasterq-dump, fastq-dump, sam-dump: fixed a problem resulting in a segmentation fault
62
63Release 2.10.2 of `sra-tools` provides access to all the **public and controlled-access dbGaP** of SRA in the AWS and GCP environments _(Linux only for this release)_. This vast archive's original submission format and SRA-formatted data can both be accessed and computed on these clouds, eliminating the need to download from NCBI FTP as well as improving performance.
64
65The `prefetch` tool also retrieves **original submission files** in addition to ETL data for public and controlled-access dbGaP data.
66
67With release 2.10.0 of `sra-tools` we have added cloud-native operation for AWS and GCP environments _(Linux only for this release)_, for use with the public SRA. `prefetch` is capable of retrieving original submission files in addition to ETL data.
68
69With release 2.9.1 of `sra-tools` we have finally made available the tool `fasterq-dump`, a replacement for the much older `fastq-dump` tool. As its name implies, it runs faster, and is better suited for large-scale conversion of SRA objects into FASTQ files that are common on sites with enough disk space for temporary files. `fasterq-dump` is multi-threaded and performs bulk joins in a way that improves performance as compared to `fastq-dump`, which performs joins on a per-record basis _(and is single-threaded)_.
70
71`fastq-dump` is still supported as it handles more corner cases than `fasterq-dump`, but it is likely to be deprecated in the future.
72
73You can get more information about `fasterq-dump` in our Wiki at [https://github.com/ncbi/sra-tools/wiki/HowTo:-fasterq-dump](https://github.com/ncbi/sra-tools/wiki/HowTo:-fasterq-dump).
74
75For additional information on using, configuring, and building the toolkit,
76please visit our [wiki](https://github.com/ncbi/sra-tools/wiki)
77or our web site at [NCBI](http://www.ncbi.nlm.nih.gov/Traces/sra/?view=toolkit_doc)
78
79
80SRA Toolkit Development Team
81