Home

Awesome

AdapterRemoval build coverage docs

AdapterRemoval searches for and removes adapter sequences from High-Throughput Sequencing (HTS) data and (optionally) trims low quality bases from the 3' end of reads following adapter removal. AdapterRemoval can analyze both single end and paired end data, and can be used to merge overlapping paired-ended reads into (longer) consensus sequences. Additionally, AdapterRemoval can construct a consensus adapter sequence for paired-ended reads, if which this information is not available.

For questions, bug reports, and/or suggestions, please use the GitHub tracker.

AdapterRemoval v3 - Dang fast(Q) processing

AdapterRemoval v3 is a major revision of AdapterRemoval, that aims to simplify usage by picking a sensible set of default settings, adding new features to handle a wider range of data, providing human readable HTML reports and machine readable JSON files, as well as greatly improving overall throughput.

AdapterRemoval v3 is still a work in progress, but alpha release 2 is available for download. Documentation is available at Read the Docs, including a guide on how to migrate from v2. Bug reports, feature requests, and other feedback is greatly appreciated.

Compiling AdapterRemoval v3 requires libdeflate, isa-l v2.30+, and a compiler with support for C++17. AVX512 support requires GCC v11, Clang v8, or later. Apple M1 is currently not supported.

AdapterRemoval v2

If you use AdapterRemoval v2, then please cite the paper:

Schubert, Lindgreen, and Orlando (2016). AdapterRemoval v2: rapid adapter
trimming, identification, and read merging. BMC Research Notes, 12;9(1):88
http://bmcresnotes.biomedcentral.com/articles/10.1186/s13104-016-1900-2

AdapterRemoval was originally published in Lindgreen 2012:

Lindgreen (2012): AdapterRemoval: Easy Cleaning of Next Generation
Sequencing Reads, BMC Research Notes, 5:337
http://www.biomedcentral.com/1756-0500/5/337/

Overview of major features

Documentation

For a detailed description of program installation and usage, please refer to the online documentation. A summary of command-line options may also be found in the manual page, accessible via the command "man AdapterRemoval" once AdapterRemoval has been installed.

Installation

Installation with Conda

If you have Conda_ installed on your system:

conda install -c bioconda adapterremoval

Installing from sources

Installing AdapterRemoval from sources requires libz and libbz2.

To compile AdapterRemoval, download the latest release, unpack the archive and then simply run "make" in the resulting folder:

wget -O adapterremoval-2.3.4.tar.gz https://github.com/MikkelSchubert/adapterremoval/archive/v2.3.4.tar.gz
tar xvzf adapterremoval-2.3.4.tar.gz
cd adapterremoval-2.3.4
make

The resulting 'AdapterRemoval' executable is located in the 'build' subdirectory and may be installed by running "make install":

sudo make install

Getting started

To run AdapterRemoval, specify the location of pair 1 and (optionally) pair 2 FASTQ using the --file1 and --file2 command-line options:

AdapterRemoval --file1 reads_1.fastq.gz --file2 reads_2.fastq.gz

By default, AdapterRemoval will save the trimmed reads in the current working directly, using filenames starting with 'your_output'.

More examples of common usage may be found in the Examples section of the online documentation: