Skip to main content

COmparative GENomics Toolkit 3: genomic sequence analysis within notebooks or on compute systems with 1000s of CPUs.

Project description

PyPI version Downloads

Build Status coverall

PyPI - Python Version Ruff

CodeQL Codacy Badge

DOI

cogent3 is a mature python library for analysis of genomic sequence data. We endeavour to provide a first-class experience within Jupyter notebooks, but the algorithms also support parallel execution on compute systems with 1000's of processors.

📣 Feature Announcements 📣

Migration to new type core objects is complete‼️

This has now been finalised with these classes being the defaults.

Major advances in our progress towards a fully plugin-based architecture!

Cogent3 supports sequence storage plugins 📦🔌🚀

We have implemented the infrastructure to support alternative sequence storage plugins. These provide the backend storage for the new type sequence collections. We have implemented a proof-of-principle plugin cogent3-h5seqs for sequence storage based on the HDF5 format. This allows efficient storage of very large sequence collections (aligned or unaligned). See the readme for that project on how to use it.

Cogent3 supports sequence format parser and writer plugins 👓✍️🔌

We have implemented the infrastructure to support third-party provision of every bioinformaticians favourite game -- parsing / writing the multitude of sequence file formats. All builtin format parsers / writers are implemented as plugins. We use third-party versions by default.

Cogent3 implements plugin hooks 🔌🪝🎉

We have implemented the infrastructure to support hook-style plugins. We have definied a single hook now -- the new type Alignment.quick_tree() method checks for an external plugin for calculation. The developers of piqtree have made the rapid-NJ algorithm available for this hook! Once installed, it is used as aln.quick_tree(use_hook="piqtree").

Note For assistance in writing your own plugins, contact us via the cogent3 discussions page.

Now distributed with sample data!

We have added sample data sets for quick testing of different features. Check out cogent3.available_datasets() to see the available datasets. You can load one using cogent3.get_dataset(name).

Who is it for?

Anyone who wants to analyse sequence divergence using robust statistical models

cogent3 is unique in providing numerous non-stationary Markov models for modelling sequence evolution, including codon models. cogent3 also includes an extensive collection of time-reversible models (again including novel codon models). We have done more than just invent these new methods, we have established the most robust algorithms for their implementation and their suitability for real data. Additionally, there are novel signal processing methods focussed on statistical estimation of integer period signals.

🎬 Demo non-reversible substitution model

Anyone who wants to undertake exploratory genomic data analysis

Beyond our novel methods, cogent3 provides an extensive suite of capabilities for manipulating and analysing sequence data. You can manipulate sequences by their annotations, e.g.

🎬 Demo sequences with annotations

Plus, you can read standard tabular and biological data formats, perform multiple sequence alignment using any cogent3 substitution models, phylogenetic reconstruction and tree manipulation, manipulation of tabular data, visualisation of phylogenies and much more.

Beginner friendly approach to genomic data analysis

Our cogent3.app module provides a very different approach to using the library capabilities. Expertise in structural programming concepts is not essential!

🎬 Demo friendly coding

Installation

For most users we recommend

$ pip install "cogent3[extra]"

which installs support for data visualisation and jupyter notebooks.

If you're running on a high-performance computing system we recommend

$ pip install cogent3

which skips the data visualisation and notebook support.

To install the development version directly from GitHub

$ pip install git+https://github.com/cogent3/cogent3.git@develop#egg=cogent3

Project Information

cogent3 is released under the BSD-3 license, documentation is at cogent3.org, while cogent3 code is on GitHub. If you would like to contribute (and we hope you do!), we have created a companion c3dev GitHub repo which provides details on how to contribute and some useful tools for doing so.

Project History

cogent3 is a descendant of PyCogent. While there is much in common with PyCogent, the amount of change has been substantial, motivating the name change to cogent3. This name has been chosen because cogent was always the import name (dating back to PyEvolve in 2004) and it's Python 3 only.

Given this history, we are grateful to the multitude of individuals who have made contributions over the years. Many of these contributors were also co-authors on the original PyEvolve and PyCogent publications. Individual contributions can be seen by using "view git blame" on individual lines of code on GitHub, through git log in the terminal, and more recently the changelog.

Funding

Cogent3 has received funding support from the Australian National University and an Essential Open Source Software for Science Grant from the Chan Zuckerberg Initiative.

         

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

cogent3-2025.7.10a2.tar.gz (17.9 MB view details)

Uploaded Source

Built Distribution

cogent3-2025.7.10a2-py3-none-any.whl (715.7 kB view details)

Uploaded Python 3

File details

Details for the file cogent3-2025.7.10a2.tar.gz.

File metadata

  • Download URL: cogent3-2025.7.10a2.tar.gz
  • Upload date:
  • Size: 17.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for cogent3-2025.7.10a2.tar.gz
Algorithm Hash digest
SHA256 0de842f0e577342a98d9682bc037fc5dbab28042196ddf3788909c81a375342c
MD5 89dc0ff57c142ff55913ca065313c370
BLAKE2b-256 80761867fc147e19f5ed6a038339ee508eae7bf2647ba8875f1adbc096a1d0be

See more details on using hashes here.

Provenance

The following attestation bundles were made for cogent3-2025.7.10a2.tar.gz:

Publisher: release.yml on cogent3/cogent3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cogent3-2025.7.10a2-py3-none-any.whl.

File metadata

  • Download URL: cogent3-2025.7.10a2-py3-none-any.whl
  • Upload date:
  • Size: 715.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for cogent3-2025.7.10a2-py3-none-any.whl
Algorithm Hash digest
SHA256 d55511bc28f63961b903f4f5e91e170c9fd465a3fac54b90f0ea2eb737a61189
MD5 1d4a808f99dc479580b113c5460f1244
BLAKE2b-256 0ff6d0f1289371e4aef0f48e306836b954ed4cff4da0af9a90301246279219f8

See more details on using hashes here.

Provenance

The following attestation bundles were made for cogent3-2025.7.10a2-py3-none-any.whl:

Publisher: release.yml on cogent3/cogent3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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