Skip to content

Commit 12f8ad9

Browse files
update README
1 parent 7fe40a9 commit 12f8ad9

File tree

1 file changed

+19
-15
lines changed

1 file changed

+19
-15
lines changed

README.md

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,16 @@ not available.
1111
For questions, bug reports, and/or suggestions, please use the
1212
[GitHub tracker](https://github.com/MikkelSchubert/adapterremoval/issues/).
1313

14+
# AdapterRemoval v3 - Dang fast(Q) processing
15+
16+
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](https://mikkelschubert.github.io/adapterremoval/examples/example.html) and machine [readable JSON files](https://mikkelschubert.github.io/adapterremoval/examples/example.json), as well as greatly improving overall throughput.
17+
18+
AdapterRemoval v3 is still a work in progress, but alpha release 2 is [available for download](https://github.com/MikkelSchubert/adapterremoval/releases/tag/v3.0.0-alpha2/). Documentation is available at [Read the Docs](https://adapterremoval.readthedocs.io/en/v3.0.0-alpha2/), including a guide on how to migrate from v2. Bug reports, feature requests, and other feedback is greatly appreciated.
19+
20+
Compiling AdapterRemoval v3 requires [libdeflate](https://github.com/ebiggers/libdeflate), [isa-l v2.30+](https://github.com/intel/isa-l), and a compiler with support for C++17. AVX512 support requires GCC v11, Clang v8, or later. Apple M1 is currently not supported.
21+
22+
# AdapterRemoval v2
23+
1424
If you use AdapterRemoval v2, then please cite the paper:
1525

1626
Schubert, Lindgreen, and Orlando (2016). AdapterRemoval v2: rapid adapter
@@ -23,20 +33,18 @@ AdapterRemoval was originally published in Lindgreen 2012:
2333
Sequencing Reads, BMC Research Notes, 5:337
2434
http://www.biomedcentral.com/1756-0500/5/337/
2535

26-
2736
## Overview of major features
2837

29-
- Trimming of adapters sequences from single-end and paired-end FASTQ reads.
30-
- Trimming of multiple, different adapters or adapter pairs.
31-
- Demultiplexing of single or double indexed reads, with or without trimming
38+
- Trimming of adapters sequences from single-end and paired-end FASTQ reads.
39+
- Trimming of multiple, different adapters or adapter pairs.
40+
- Demultiplexing of single or double indexed reads, with or without trimming
3241
of adapter sequences.
33-
- Reconstruction of adapter sequences from paired-end reads, by the pairwise
42+
- Reconstruction of adapter sequences from paired-end reads, by the pairwise
3443
alignment of reads in the absence of a known adapter sequence.
35-
- Merging of overlapping read-pairs into higher-quality consensus sequences.
36-
- Multi-threading of all operations for increased throughput.
37-
- Reading and writing of gzip and bzip2 compressed files.
38-
- Reading and writing of interleaved FASTQ files.
39-
44+
- Merging of overlapping read-pairs into higher-quality consensus sequences.
45+
- Multi-threading of all operations for increased throughput.
46+
- Reading and writing of gzip and bzip2 compressed files.
47+
- Reading and writing of interleaved FASTQ files.
4048

4149
## Documentation
4250

@@ -45,7 +53,6 @@ the [online documentation](https://adapterremoval.readthedocs.io/). A summary
4553
of command-line options may also be found in the manual page, accessible via
4654
the command "man AdapterRemoval" once AdapterRemoval has been installed.
4755

48-
4956
## Installation
5057

5158
### Installation with Conda
@@ -54,7 +61,6 @@ If you have `Conda`_ installed on your system:
5461

5562
conda install -c bioconda adapterremoval
5663

57-
5864
### Installing from sources
5965

6066
Installing AdapterRemoval from sources requires libz and libbz2.
@@ -72,7 +78,6 @@ subdirectory and may be installed by running "make install":
7278

7379
sudo make install
7480

75-
7681
## Getting started
7782

7883
To run AdapterRemoval, specify the location of pair 1 and (optionally) pair 2
@@ -81,8 +86,7 @@ FASTQ using the --file1 and --file2 command-line options:
8186
AdapterRemoval --file1 myreads_1.fastq.gz --file2 myreads_2.fastq.gz
8287

8388
By default, AdapterRemoval will save the trimmed reads in the current working
84-
directly, using filenames starting with 'your_output'.
85-
89+
directly, using filenames starting with 'your_output'.
8690

8791
More examples of common usage may be found in the
8892
[Examples](https://adapterremoval.readthedocs.io/en/latest/examples.html)

0 commit comments

Comments
 (0)