Skip to main content

A toolkit for assigning objective taxonomic classifications to bacterial and archaeal genomes.

Project description

GTDB-Tk

PyPI PyPI Downloads Bioconda BioConda Downloads Docker Image Version (latest by date) Docker Pulls

GTDB-Tk is a software toolkit for assigning objective taxonomic classifications to bacterial and archaeal genomes based on the Genome Database Taxonomy (GTDB). It is designed to work with recent advances that allow hundreds or thousands of metagenome-assembled genomes (MAGs) to be obtained directly from environmental samples. It can also be applied to isolate and single-cell genomes. The GTDB-Tk is open source and released under the GNU General Public License (Version 3).

Notifications about GTDB-Tk releases will be available through the GTDB Twitter account and the GTDB Announcements Forum.

Please post questions and issues related to GTDB-Tk on the Issues section of the GitHub repository. Questions related to the GTDB can be posted on the GTDB Forum or sent to the GTDB team.

🚀 Getting started

Be sure to check the hardware requirements, then choose your preferred method:

📖 Documentation

Documentation for GTDB-Tk can be found here.

✨ New Features

GTDB-Tk v2.2.0+ includes the following new features:

  • GTDB-TK classify and classify_wf have changed in version 2.2.0+. There is now an ANI classification stage (ANI screen) that precedes classification by placement in a reference tree.
    • This is now the default behavior for classify and classify_wf.
    • In classify, user genomes are first compared against a Mash database comprised of all GTDB representative genomes and genome pairs of sufficient similarity processed by FastANI. User genomes classified to a GTDB representative based on FastANI results are not run through pplacer.
    • In the classify_wf workflow, genomes are classified using Mash and FastANI before executing the identify step. User genomes classified with FastANI are not run through the remainder of the pipeline (identify, align, classify).
    • To classify genomes without the additional ani_screen step, use the --skip_ani_screen flag.

📈 Performance

Using ANI screen "can" reduce computation by >50%, although it depends on the set of input genomes. A set of input genomes consisting primarily of new species will not benefit from ANI screen as much as a set of genomes that are largely assigned to GTDB species clusters. In the latter case, the ANI screen will reduce the number of genomes that need to be classified by pplacer which reduces computation time subsantially (between 25% and 60% in our testing).

📚 References

GTDB-Tk is described in:

The Genome Taxonomy Database (GTDB) is described in:

We strongly encourage you to cite the following 3rd party dependencies:

© Copyright

Copyright 2017 Pierre-Alain Chaumeil. See LICENSE for further details.

Project details


Download files

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

Source Distribution

gtdbtk-2.2.1.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gtdbtk-2.2.1-py3-none-any.whl (1.8 MB view details)

Uploaded Python 3

File details

Details for the file gtdbtk-2.2.1.tar.gz.

File metadata

  • Download URL: gtdbtk-2.2.1.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for gtdbtk-2.2.1.tar.gz
Algorithm Hash digest
SHA256 b4519056fbd91bcaa7cf7e09c1f558df3609e8968d15e15dedd5d925449b0448
MD5 82f20ab0a188d6dc3b63c30b947ab3af
BLAKE2b-256 9cceb46fe9815e149aa238471118f5ffb50d67eab2b4c8a94d1fe3a480052166

See more details on using hashes here.

File details

Details for the file gtdbtk-2.2.1-py3-none-any.whl.

File metadata

  • Download URL: gtdbtk-2.2.1-py3-none-any.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.16

File hashes

Hashes for gtdbtk-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b1025b4dae7a8bd3edae67621f63b962151bd5d63344968d9e13ac0c40adef8a
MD5 e4a1c35421bd46b7875898c7afd1393e
BLAKE2b-256 3cadd6016544dd8d2dc164569b328307dc09e7029112016b87941180cd3fd3e3

See more details on using hashes here.

Supported by

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