Skip to content

Commit

Permalink
update STAR to version 2.7.10a
Browse files Browse the repository at this point in the history
  • Loading branch information
suhrig committed Jan 15, 2022
1 parent 73fad9f commit 46d7951
Show file tree
Hide file tree
Showing 4 changed files with 4 additions and 9 deletions.
4 changes: 2 additions & 2 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ apt-get install -y --no-install-recommends wget ca-certificates samtools r-base
apt-get clean && rm -rf /var/lib/apt/lists/*

# install version of STAR that supports --chimMultimapNmax and --chimOutType WithinBAM
RUN wget -qO - 'https://github.com/alexdobin/STAR/archive/2.7.6a.tar.gz' | \
tar --strip-components=3 -C /usr/local/bin -xzf - 'STAR-2.7.6a/bin/Linux_x86_64/STAR'
RUN wget -qO - 'https://github.com/alexdobin/STAR/archive/2.7.10a.tar.gz' | \
tar --strip-components=3 -C /usr/local/bin -xzf - 'STAR-2.7.10a/bin/Linux_x86_64/STAR'

# install arriba
RUN wget -qO - 'https://github.com/suhrig/arriba/releases/download/v2.1.0/arriba_v2.1.0.tar.gz' | tar -xzf - --exclude='arriba*/.git'
Expand Down
5 changes: 0 additions & 5 deletions documentation/current-limitations.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,6 @@ Adapter trimming

In most cases, it is not necessary to trim adapters, because STAR is capable of performing clipped alignments, such that reads with adapters will simply be aligned partially. For this reason, the demo script `run_arriba.sh` does not perform adapter trimming. However, if many reads contain a substantial fraction of adapter sequence, it can be beneficial to remove adapters for improved sensitivity, because STAR dismisses chimeric alignments when a big fraction of a read cannot be aligned (as controlled by the parameter `--outFilterMatchNminOverLread`). To this end, the STAR parameter `--clip3pAdapterSeq` can be used or a specialized adapter trimming tool.

Small insert size
-----------------

Due to a [bug in STAR](https://github.com/alexdobin/STAR/issues/1135), when the insert size is small, such that paired-end mates fully overlap, STAR may produce malformed chimeric alignments. This is a bug in the paired-end overlap merge feature of STAR (see parameter `--peOverlapNbasesMin`) and only manifests when this feature is enabled. Despite this bug, it is highly recommended to enable the feature, because otherwise chimeric reads of fully (or partially) overlapping paired-end mates will not be aligned at all. The bug only affects fully overlapping paired-end mates (but not partially overlapping mates) and of those only 50% at random, such that even in view of the bug, there still is a major benefit in enabling the paired-end overlap merge feature. However, when the majority of the reads overlaps fully, this means that up to 50% of the chimeric alignments cannot be used by Arriba, which obviously impairs fusion detection. In such cases, it is recommended to align just one of the mates of fully overlapping reads in single-end mode, where the bug does not apply. More importantly, users should seek to improve their library preparation protocol to produce longer insert sizes, because there is no point in performing paired-end sequencing when the information of the paired-end mates is identical. This is effectively the same as performing single-end sequencing. For optimal fusion detection, the insert size should be just about big enough that the paired-end mates do not overlap.

Viral detection
---------------

Expand Down
2 changes: 1 addition & 1 deletion documentation/quickstart.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Manual installation
-------------------

Arriba has only a single prerequisite: [STAR](https://github.com/alexdobin/STAR) (version >=2.7.6a recommended). Download and install the tool according to the developers' instructions and make it available in your `$PATH`. If you want to make use of Arriba's [visualization tools](visualization.md), a few additional software components [need to be installed](visualization.md#publication-quality-figures).
Arriba has only a single prerequisite: [STAR](https://github.com/alexdobin/STAR) (version >=2.7.10a recommended). Download and install the tool according to the developers' instructions and make it available in your `$PATH`. If you want to make use of Arriba's [visualization tools](visualization.md), a few additional software components [need to be installed](visualization.md#publication-quality-figures).

Compile the latest stable version of Arriba or use the precompiled binaries in the download file. **Note: You should not use `git clone` to download Arriba, because the git repository does not include the blacklist! Instead, download the latest tarball from the [releases page](https://github.com/suhrig/arriba/releases/) as shown here:**

Expand Down
2 changes: 1 addition & 1 deletion run_arriba.sh
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ READ2="${9-}"
# find installation directory of arriba
BASE_DIR=$(dirname "$0")

# align FastQ files (STAR >=2.7.6a recommended)
# align FastQ files (STAR >=2.7.10a recommended)
STAR \
--runThreadN "$THREADS" \
--genomeDir "$STAR_INDEX_DIR" --genomeLoad NoSharedMemory \
Expand Down

0 comments on commit 46d7951

Please sign in to comment.