.. image:: https://img.shields.io/github/license/peterjc/q2-thapbi-pict.svg?label=License
:alt: MIT License
:target: https://github.com/peterjc/q2-thapbi-pict/blob/main/LICENSE.rst
.. image:: https://results.pre-commit.ci/badge/github/peterjc/q2-thapbi-pict/main.svg
:target: https://results.pre-commit.ci/latest/github/peterjc/q2-thapbi-pict/main
:alt: pre-commit.ci status
.. image:: https://img.shields.io/pypi/v/q2_thapbi_pict.svg?label=PyPI
:alt: Released on the Python Package Index (PyPI)
:target: https://pypi.org/project/q2-thapbi-pict/
.. image:: https://img.shields.io/badge/Code%20style-black-000000.svg
:alt: Code style: black
:target: https://github.com/python/black
Qiime2 plugin for THAPBI PICT (q2-thapbi-pict)
==============================================
About
-----
`Qiime2 <https://qiime2.org/>`__ is a microbiome bioinformatics platform with
integrated data provenance tracking and a `plugin system
<https://library.qiime2.org/plugins/>`__ allowing modular construction of
analysis and visualisation pipelines.
`THAPBI PICT <https://github.com/peterjc/thapbi-pict>`__ is a sequence based
diagnostic/profiling tool started under the UK funded Tree Health and Plant
Biosecurity Initiative (THAPBI) `Phyto-Threats project
<https://www.forestresearch.gov.uk/research/global-threats-from-phytophthora-spp/>`__.
PICT stood for *Phytophthora* ITS1 Classification Tool, reflecting the initial
application focus.
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.
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 THAPBI PICT tool provides a command line interface including a pipeline
from demultiplexed FASTQ files and optional metadata as TSV files though to
ASV tally tables with taxonomic classification as TSV, Excel or BIOM files.
This repository is for ``q2-thapbi-pict``, a plugin to call some of the THAPBI
PICT functionality from within Qiime2.
Installation
------------
Qiime2 is not available natively on Windows, instead they recommend using the
Windows Subsystem for Linux (WSL). Follow the Qiime2 installation instructions
using the `Conda <https://conda.io/>`__ packaging system.
1. Activate your Qiime2 conda environment.
2. Install the paired read merging tool Flash used by THAPBI PICT using conda:
.. code:: console
$ conda install -c conda-forge flash
3. Install the THAPBI PICT plugin for Qiime2 (and its Python dependencies which
include THAPBI PICT and CutAdapt) using pip:
.. code:: console
$ pip install q2-thapbi-pict
This will fail ``ERROR: No matching distribution found for q2-types...`` or
``ERROR: No matching distribution found for q2cli...`` if the Qiime2 conda
environment is not activated.
Quick Start
-----------
Once installed, you should be able to run the tool at the command line using
the Qiime2 command line interface (q2cli):
.. code:: console
$ qiime info
System versions
Python version: 3.8.18
QIIME 2 release: 2024.2
QIIME 2 version: 2024.2.0
q2cli version: 2024.2.0
Installed plugins
...
This should list the THAPBI PICT plugin under "Installed plugins". You should
be able to run it and see basic instructions too:
.. code:: console
$ qiime q2-thapbi-pict --help
Usage: qiime q2-thapbi-pict [OPTIONS] COMMAND [ARGS]...
Description: This QIIME 2 plugin provides support for running some of the
THAPBI PICT functionality.
...
This lists the available commands, each of which have their own help page:
.. code:: console
$ qiime q2-thapbi-pict prepare-reads-sample-tally --help
Usage: qiime q2-thapbi-pict prepare-reads-sample-tally [OPTIONS]
Takes paired (raw) FASTQ files demultiplexed per sample. Runs THAPBI PICT
...
You can confirm the plugin version like this:
.. code:: console
$ qiime q2-thapbi-pict --version
QIIME 2 Plugin 'q2-thapbi-pict' version 0.0.1 (from package 'q2-thapbi-pict' version 0.0.1)
Documentation
-------------
The `THAPBI PICT documentation <https://thapbi-pict.readthedocs.io/>`_ is
hosted by `Read The Docs <https://readthedocs.org/>`_.
Citation
--------
If you use THAPBI PICT in your work, please cite our *PeerJ* paper, 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" *PeerJ* **11**:e15648
https://doi.org/10.7717/peerj.15648
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.
Qiime2 helps by tracking the citations for all the tools your analysis uses.
This should include any tools used via plugins, such as Flash and CutAdapt.
Raw data
{
"_id": null,
"home_page": "https://github.com/peterjc/q2-thapbi-pict",
"name": "q2-thapbi-pict",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "Peter Cock",
"author_email": "peter.cock@hutton.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/fa/ea/0d0b7de888a8a6fc48518137d34f80267f74a0b876e0a74fdd46016af649/q2_thapbi_pict-0.0.1.tar.gz",
"platform": null,
"description": ".. image:: https://img.shields.io/github/license/peterjc/q2-thapbi-pict.svg?label=License\n :alt: MIT License\n :target: https://github.com/peterjc/q2-thapbi-pict/blob/main/LICENSE.rst\n.. image:: https://results.pre-commit.ci/badge/github/peterjc/q2-thapbi-pict/main.svg\n :target: https://results.pre-commit.ci/latest/github/peterjc/q2-thapbi-pict/main\n :alt: pre-commit.ci status\n.. image:: https://img.shields.io/pypi/v/q2_thapbi_pict.svg?label=PyPI\n :alt: Released on the Python Package Index (PyPI)\n :target: https://pypi.org/project/q2-thapbi-pict/\n.. image:: https://img.shields.io/badge/Code%20style-black-000000.svg\n :alt: Code style: black\n :target: https://github.com/python/black\n\n\nQiime2 plugin for THAPBI PICT (q2-thapbi-pict)\n==============================================\n\nAbout\n-----\n\n`Qiime2 <https://qiime2.org/>`__ is a microbiome bioinformatics platform with\nintegrated data provenance tracking and a `plugin system\n<https://library.qiime2.org/plugins/>`__ allowing modular construction of\nanalysis and visualisation pipelines.\n\n`THAPBI PICT <https://github.com/peterjc/thapbi-pict>`__ is a sequence based\ndiagnostic/profiling tool started under the UK funded Tree Health and Plant\nBiosecurity Initiative (THAPBI) `Phyto-Threats project\n<https://www.forestresearch.gov.uk/research/global-threats-from-phytophthora-spp/>`__.\nPICT stood for *Phytophthora* ITS1 Classification Tool, reflecting the initial\napplication focus.\n\nWith appropriate primer settings and a custom database of full length markers,\nTHAPBI PICT can be applied to other organisms and/or barcode marker sequences.\nIt requires overlapping paired-end Illumina reads which can be merged to cover\nthe *full* amplicon marker. Longer markers or fragmented amplicons are not\nsupported. Internally it works by tracking unique amplicon sequence variants\n(ASVs), using MD5 checksums as identifiers.\n\nThe THAPBI PICT tool provides a command line interface including a pipeline\nfrom demultiplexed FASTQ files and optional metadata as TSV files though to\nASV tally tables with taxonomic classification as TSV, Excel or BIOM files.\n\nThis repository is for ``q2-thapbi-pict``, a plugin to call some of the THAPBI\nPICT functionality from within Qiime2.\n\n\nInstallation\n------------\n\nQiime2 is not available natively on Windows, instead they recommend using the\nWindows Subsystem for Linux (WSL). Follow the Qiime2 installation instructions\nusing the `Conda <https://conda.io/>`__ packaging system.\n\n1. Activate your Qiime2 conda environment.\n\n2. Install the paired read merging tool Flash used by THAPBI PICT using conda:\n\n .. code:: console\n\n $ conda install -c conda-forge flash\n\n3. Install the THAPBI PICT plugin for Qiime2 (and its Python dependencies which\n include THAPBI PICT and CutAdapt) using pip:\n\n .. code:: console\n\n $ pip install q2-thapbi-pict\n\n This will fail ``ERROR: No matching distribution found for q2-types...`` or\n ``ERROR: No matching distribution found for q2cli...`` if the Qiime2 conda\n environment is not activated.\n\nQuick Start\n-----------\n\nOnce installed, you should be able to run the tool at the command line using\nthe Qiime2 command line interface (q2cli):\n\n.. code:: console\n\n $ qiime info\n System versions\n Python version: 3.8.18\n QIIME 2 release: 2024.2\n QIIME 2 version: 2024.2.0\n q2cli version: 2024.2.0\n\n Installed plugins\n ...\n\nThis should list the THAPBI PICT plugin under \"Installed plugins\". You should\nbe able to run it and see basic instructions too:\n\n.. code:: console\n\n $ qiime q2-thapbi-pict --help\n Usage: qiime q2-thapbi-pict [OPTIONS] COMMAND [ARGS]...\n\n Description: This QIIME 2 plugin provides support for running some of the\n THAPBI PICT functionality.\n\n ...\n\nThis lists the available commands, each of which have their own help page:\n\n.. code:: console\n\n $ qiime q2-thapbi-pict prepare-reads-sample-tally --help\n Usage: qiime q2-thapbi-pict prepare-reads-sample-tally [OPTIONS]\n\n Takes paired (raw) FASTQ files demultiplexed per sample. Runs THAPBI PICT\n ...\n\nYou can confirm the plugin version like this:\n\n.. code:: console\n\n $ qiime q2-thapbi-pict --version\n QIIME 2 Plugin 'q2-thapbi-pict' version 0.0.1 (from package 'q2-thapbi-pict' version 0.0.1)\n\n\nDocumentation\n-------------\n\nThe `THAPBI PICT documentation <https://thapbi-pict.readthedocs.io/>`_ is\nhosted by `Read The Docs <https://readthedocs.org/>`_.\n\n\nCitation\n--------\n\nIf you use THAPBI PICT in your work, please cite our *PeerJ* paper, and give\ndetails of the version and any non-default settings used in your methods:\n\n Cock *et al.* (2023) \"THAPBI PICT - a fast, cautious, and accurate\n metabarcoding analysis pipeline\" *PeerJ* **11**:e15648\n https://doi.org/10.7717/peerj.15648\n\nYou can also cite the software specifically via Zenodo which offers version\nspecific DOIs as well as https://doi.org/10.5281/zenodo.4529395 which is for\nthe latest version.\n\nQiime2 helps by tracking the citations for all the tools your analysis uses.\nThis should include any tools used via plugins, such as Flash and CutAdapt.\n",
"bugtrack_url": null,
"license": "",
"summary": "Qiime2 plugin for THAPBI PICT.",
"version": "0.0.1",
"project_urls": {
"Documentation": "https://thapbi-pict.readthedocs.io/",
"Download": "https://github.com/peterjc/q2-thapbi-pict",
"Homepage": "https://github.com/peterjc/q2-thapbi-pict",
"Source": "https://github.com/peterjc/q2-thapbi-pict/",
"Tracker": "https://github.com/peterjc/q2-thapbi-pict/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f2646e5af46c7fe05dc0b1543d6733db25986de359766294eba25555667a8d3b",
"md5": "61807347108063ddc6adbdd2c21edd4e",
"sha256": "3349eb95809018ec279d98b648ab1c8ec6043a0bc03ca54457a6e2a055c156df"
},
"downloads": -1,
"filename": "q2_thapbi_pict-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "61807347108063ddc6adbdd2c21edd4e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 11761,
"upload_time": "2024-03-13T15:51:04",
"upload_time_iso_8601": "2024-03-13T15:51:04.542270Z",
"url": "https://files.pythonhosted.org/packages/f2/64/6e5af46c7fe05dc0b1543d6733db25986de359766294eba25555667a8d3b/q2_thapbi_pict-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "faea0d0b7de888a8a6fc48518137d34f80267f74a0b876e0a74fdd46016af649",
"md5": "864892c4dea7ffb20d549fc9b9838b80",
"sha256": "23a34b0e52f691edccd8d524b8af7b8b148e6b9f248efc3a6a0457feb629efaa"
},
"downloads": -1,
"filename": "q2_thapbi_pict-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "864892c4dea7ffb20d549fc9b9838b80",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 13276,
"upload_time": "2024-03-13T15:51:06",
"upload_time_iso_8601": "2024-03-13T15:51:06.050611Z",
"url": "https://files.pythonhosted.org/packages/fa/ea/0d0b7de888a8a6fc48518137d34f80267f74a0b876e0a74fdd46016af649/q2_thapbi_pict-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-13 15:51:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "peterjc",
"github_project": "q2-thapbi-pict",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "q2-thapbi-pict"
}
JSON
