Skip to main content

ITSxpress: Software to rapidly trim the Internally transcribed spacer (ITS) region of FASTQ files

https://travis-ci.org/USDA-ARS-GBRU/itsxpress.svg?branch=master Documentation Status https://codecov.io/gh/USDA-ARS-GBRU/itsxpress/branch/master/graph/badge.svg https://api.codacy.com/project/badge/Grade/7e2a4c97cde74bccb3e84b706d7a2aa5 https://zenodo.org/badge/DOI/10.5281/zenodo.1304349.svg

Author

  • Adam R. Rivers, US Department of Agriculture, Agricultural Research Service

Citation

Rivers AR, Weber KC, Gardner TG et al. ITSxpress: Software to rapidly trim internally transcribed spacer sequences with quality scores for marker gene analysis [version 1; referees: awaiting peer review]. F1000Research 2018, 7:1418 (doi: 10.12688/f1000research.15704.1)

Introduction

The internally transcribed spacer region is a region between highly conserved the small subunit (SSU) of rRNA and the large subunit (LSU) of the rRNA. In Eukaryotes it contains the 5.8s genes and two variable length spacer regions. In amplicon sequencing studies it is common practice to trim off the conserved (SSU, 5,8S or LSU) regions. Bengtsson-Palme et al. (2013) published software the software package ITSx to do this.

ITSxpress is designed to support the calling of exact sequence variants rather than OTUs. This newer method of sequence error-correction requires quality score data from each sequence, so each input sequence must be trimmed. ITSXpress makes this possible by taking FASTQ data, de-replicating the sequences then identifying the start and stop sites using HMMSearch. Results are parsed and the trimmed files are returned. The ITS 1, ITS2 or the entire ITS region including the 5.8s rRNA gene can be selected. ITSxpress uses the hmm model from ITSx so results are comparable.

ITSxpress is also available as a QIIME2 Plugin

Installation

ITSxpress can be installed from:

  1. Bioconda: (preferred method because it handles dependencies):

conda install itsxpress
  1. Pip: https://pypi.org/project/itsxpress/:

pip install itsxpress
  1. The Github repository: https://github.com/USDA-ARS-GBRU/itsxpress

git clone https://github.com/USDA-ARS-GBRU/itsxpress.git

Dependencies

The software requires Vsearch, BBtools, Hmmer >= 3.1b and Biopython. Bioconda takes care of this for you so it is the preferred installation method.

Usage

-h, --help

Show this help message and exit.

--fastq

A .fastq, .fq, .fastq.gz or .fq.gz file. Interleaved or not. Required.

--single_end

A flag to specify that the fastq file is single-ended (not paired). single-ended (not paired). Default is false.

--fastq2

A .fastq, .fq, .fastq.gz or .fq.gz file representing read 2 if present, optional.

--outfile

The trimmed FASTQ file, if it ends in gz it will be gzipped.

--outfile2

The trimmed FASTQ read 2 file, if it ends in gz it will be gzipped. If used, reads will be retuned as unmerged pairs rather than than merged.

--tempdir

Specify the temp file directory. Default is None.

--keeptemp

Should intermediate files be kept? Default is false.

--region

Options : {ITS2, ITS1, ALL}

--taxa

Select the taxonomic group sequenced: {Alveolata, Bryophyta, Bacillariophyta, Amoebozoa, Euglenozoa, Fungi, Chlorophyta, Rhodophyta, Phaeophyceae, Marchantiophyta, Metazoa, Oomycota, Haptophyceae, Raphidophyceae, Rhizaria, Synurophyceae, Tracheophyta, Eustigmatophyceae, All}. Default Fungi.

--cluster_id

The percent identity for clustering reads range [0.98-1.0], set to 1 for exact dereplication. Default 0.995.

--log

Log file. Default is ITSxpress.log.

--threads

Number of processor threads to use. Default is 1.

Examples

Use case 1: Trimming the ITS2 region from a fungal amplicon sequencing dataset with forward and reverse gzipped FASTQ files using two cpu threads. Return a single merged file for use in Deblur.

itsxpress --fastq r1.fastq.gz --fastq2 r2.fastq.gz --region ITS2 \
--taxa Fungi --log logfile.txt --outfile trimmed_reads.fastq.gz --threads 2

ITSxpress can take gzipped or un-gzipped FASTQ files and it can write gzipped or un-gzipped FASTQ files. It expects FASTQ files to end in: .fq, .fastq, .fq.gz or fastq.gz.

Use case 2: Trimming the ITS2 region from a fungal amplicon sequencing dataset with forward and reverse gzipped FASTQ files using two cpu threads. Return a forward and reverse read files for use in Dada2.

itsxpress --fastq r1.fastq.gz --fastq2 r2.fastq.gz --region ITS2 \
--taxa Fungi --log logfile.txt --outfile trimmed_reads.fastq.gz --threads 2

ITSxpress can take gzipped or un-gzipped FASTQ files and it can write gzipped or un-gzipped FASTQ files. It expects FASTQ files to end in: .fq, .fastq, .fq.gz or fastq.gz.

Use case 3: Trimming the ITS2 region from a fungal amplicon sequencing dataset with an interleaved gzipped FASTQ files using two cpu threads. Return a single merged file for use in Deblur.

itsxpress --fastq interleaved.fastq.gz  --region ITS2 --taxa Fungi \
--log logfile.txt --outfile trimmed_reads.fastq.gz --threads 2

Use case 4: Trimming the ITS2 region from a fungal amplicon sequencing dataset with an single-ended gzipped FASTQ files using two cpu threads.

itsxpress --fastq single-end.fastq.gz --single_end --region ITS2 --taxa Fungi \
--log logfile.txt --outfile trimmed_reads.fastq.gz --threads 2

Single ended data is less common and may come from a dataset where the reads have already been merged.

Use case 5: Trimming the ITS1 region from a Alveolata amplicon sequencing dataset with an interleaved gzipped FASTQ files using 40 cpu threads.

itsxpress --fastq interleaved.fastq.gz --region ITS1 --taxa Alveolata \
--log logfile.txt --outfile trimmed_reads.fastq.gz --threads 40

License information

This software is a work of the United States Department of Agriculture, Agricultural Research Service and is released under a Creative Commons CC0 public domain attribution.

Metadata

Release files for itsxpress 1.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for itsxpress 1.7.1
File Size Uploaded
itsxpress-1.7.1.tar.gz 2.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for itsxpress 1.7.1
File Interpreter ABI Platform
itsxpress-1.7.1-py3-none-any.whl Python 3 none any Details

Total release size: 3.5 MB

Release files / itsxpress-1.7.1.tar.gz

Download URL itsxpress-1.7.1.tar.gz
Size 2.0 MB
Tags Source
SHA-256 checksum
How to use checksums
2e04503cb1c4261e75672dfb7c2999ce27fac539d8918ec5ebd53392216d2164
BLAKE2b-256 checksum
How to use checksums
60b6ae28b83b30411da759b054355b97f46f22ae21cf453d046f5ead16408a4c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.5.5

Release files / itsxpress-1.7.1-py3-none-any.whl

Download URL itsxpress-1.7.1-py3-none-any.whl
Size 1.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d28784f7b1d10a99f27a1dcdf9789f8f8e61a629e5be157020a6b14a9cc3a182
BLAKE2b-256 checksum
How to use checksums
1625e716865df5608de93db17a03ec45b280fcdea970d6bfdfe4aa9b330566f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.5.5

Release history Release notifications | RSS feed

1.8.1

2 release files

1.8.0

2 release files

1.7.2

2 release files

This release

1.7.1 This release

2 release files

1.7.0

2 release files

1.6.4

2 release files

1.6.3

2 release files

1.6.2

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.7

2 release files

1.5.6

2 release files

1.5.5

2 release files

1.5.4

2 release files

1.5.3

2 release files

1.5.2

2 release files

1.5.1

2 release files

0.1.5

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page