Skip to main content

THAPBI Phytophthora ITS1 Classifier Tool (PICT).

Project description

Zenodo DOI MIT License pre-commit.ci status CircleCI status AppVeyor status Documentation Status THAPBI PICT on the Python Package Index (PyPI) THAPBI PICT on BioConda Code style: black

THAPBI Phytophthora ITS1 Classifier Tool (PICT)

About

THAPBI PICT is a sequence based diagnostic/profiling tool from the UK funded Tree Health and Plant Biosecurity Initiative (THAPBI) Phyto-Threats project, initially focused on identifying Phytophthora species present in Illumina sequenced environmental samples.

Phytophthora (from Greek meaning plant-destroyer) species are economically important plant pathogens, in both agriculture and forestry. ITS1 is short for Internal Transcribed Spacer one, which is a region of eukaryotes genomes between the 18S and 5.8S rRNA genes. This is commonly used for molecular barcoding, where sequencing this short region can identify species.

With appropriate primer settings and a custom database of full length markers, THAPBI PICT can be applied to other organisms and/or barcode marker sequences - not just Phytophthora ITS1. It requires overlapping paired-end Illumina reads which can be merged to cover the full amplicon marker. Longer markers or fragmented amplicons are not supported. Internally it works by tracking unique amplicon sequence variants (ASVs), using MD5 checksums as identifiers.

The worked examples include oomycetes, fungi, fish, bats, and plants, and cover markers in ITS1, ITS2, 12S, 16S, COI, and more. The main criteria has been mock communities with known species composition.

Installation

We recommend installing this tool on Linux or macOS using the Conda packaging system, via the BioConda channel, which will handle all the dependencies:

$ conda install thapbi-pict

Alternatively or on Windows, since the software is on the Python Package Index (PyPI), the following command will install it along with its Python dependencies:

$ pip install thapbi-pict

However, in this case you will still need to install various external command line tools. See INSTALL.rst for more details (especially for Windows), and if you want to modify the software read CONTRIBUTING.rst as well.

Quick Start

Once installed, you should be able to run the tool at the command line using:

$ thapbi_pict

This should automatically find the installed copy of the Python code. Use thapbi_pict -v to report the version, or thapbi_pict -h for help.

Documentation

The tool documentation is hosted by Read The Docs, generated automatically from the docs/ folder.

The documentation includes more detailed discussion of the sample datasets in the examples/ folder (which are based on published datasets).

Citation

If you use THAPBI PICT in your work, please cite this manuscript (to appear in the journal PeerJ but currently only available as a preprint), and give details of the version and any non-default settings used in your methods:

Cock et al. (2023) “THAPBI PICT - a fast, cautious, and accurate metabarcoding analysis pipeline” bioRxiv https://doi.org/10.1101/2023.03.24.534090

You can also cite the software specifically via Zenodo which offers version specific DOIs as well as https://doi.org/10.5281/zenodo.4529395 which is for the latest version.

Funding

The initial work was supported from 2016 to 2019 under the Tree Health and Plant Biosecurity Initiative (THAPBI) Phyto-Threats project:

This research was supported by a grant funded jointly by the Biotechnology and Biological Sciences Research Council (BBSRC), Department for Environment, Food and Rural affairs (DEFRA), Economic and Social Research Council (ESRC), Forestry Commission, Natural Environment Research Council (NERC) and Scottish Government, under the Tree Health and Plant Biosecurity Initiative, grant number BB/N023463/1.

Work from 2020 to 2021 was supported in part under the Early detection of Phytophthora in EU and third country nurseries and traded plants (ID-PHYT) Euphresco project:

Funded by DEFRA as part of the Future Proofing Plant Health project in support of Euphresco ID-PHYT.

Work from 2022 to 2027 was partly funded by the Rural & Environment Science & Analytical Services (RESAS) Division of the Scottish Government.

Background

THAPBI PICT continues earlier work including:

Release History

See the CHANGELOG.rst file.

Development Notes

See file CONTRIBUTING.rst for details of the development setup including Python style conventions, git pre-commit hook, continuous integration and test coverage, and release process.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

thapbi_pict-1.0.1.tar.gz (2.6 MB view details)

Uploaded Source

Built Distribution

thapbi_pict-1.0.1-py3-none-any.whl (468.1 kB view details)

Uploaded Python 3

File details

Details for the file thapbi_pict-1.0.1.tar.gz.

File metadata

  • Download URL: thapbi_pict-1.0.1.tar.gz
  • Upload date:
  • Size: 2.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.15

File hashes

Hashes for thapbi_pict-1.0.1.tar.gz
Algorithm Hash digest
SHA256 aa23cfbdb748eb931e17fa92f63145d7b5cdac44c86ff098aa00e04fd3c9683b
MD5 4f9abbc20b14ad27233bc946d4b6777d
BLAKE2b-256 3d6ca4b36711d64d37226dd02992d556fb8c3208b91d878e1c3cf2a3e067fdc8

See more details on using hashes here.

File details

Details for the file thapbi_pict-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: thapbi_pict-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 468.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.15

File hashes

Hashes for thapbi_pict-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 45ce5bff6a84a2af6929dd1b776afb430bd95ad852ea018ada65db0fd56d6beb
MD5 ff266e5717acd35feaba6a3cba881ace
BLAKE2b-256 3e1eca13617eeb5fdff124374c4185a522b7c892edb7794c35a35178cf0d3e8b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page