qdiv: Microbial Diversity Analysis Toolkit
qdiv is a Python toolkit for microbial diversity analysis, built around the robust and intuitive Hill number framework.
Features
-
Data Management: Load and validate data from multiple formats (CSV/TSV, FASTA, Newick). Functions for subsetting, rarefaction, merging, renaming, tree pruning, and more.
-
Diversity analysis: Compute multiple alpha and beta diversity metrics based on the Hill number framework.
-
Statistical methods: Integrate diversity metrics using the Hill number framework into null models (Raup–Crick, NRI, NTI), ordinations (PCoA, db-RDA), PERMANOVA, and Mantel tests.
-
Visualization: Heatmaps, ordinations, and diversity plots, and more.
Installation
pip install qdiv
Optional acceleration (Numba)
Some functions in the sequence_comparisons module support compilation via Numba. Installing qdiv with the optional accelerate extra enables faster sequence distance computations.
pip install qdiv[accelerate]
Documentation
Full documentation is available at: https://qdiv.readthedocs.io
Licence
From version 4.0.0, qdiv is licensed under the https://opensource.org/licenses/BSD-3-Clause. Previous versions were released under the GNU General Public License v3.0 (GPL-3.0).
Contributing
Contributions are welcome! Please read the CONTRIBUTING.md for details on:
- How to report bugs
- How to request new features
- How to submit pull requests
Support
If you need help with qdiv:
- Browse existing issues
- If needed, open a support issue. See SUPPORT.md.
Code of Conduct
To ensure a welcoming environment, this project follows the standards outlined in the CODE_OF_CONDUCT.md. All contributors are expected to uphold this code.
Citation
If you use qdiv in your research, please cite:
Modin. (2026). qdiv: A Python package for microbial ecology analysis using the Hill number framework. Journal of Open Source Software, 11(121), 10089. https://doi.org/10.21105/joss.10089.
Download the citation here:
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file qdiv-4.1.0.tar.gz.
File metadata
- Download URL: qdiv-4.1.0.tar.gz
- Upload date:
- Size: 681.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d07b7939ad5e24a93f69d12a91ae2babffe1bbe921d0c1fd6c37a89be5f88b9f
|
|
| MD5 |
111a81972b4fc2d82111f220f447c385
|
|
| BLAKE2b-256 |
25af9ec755c7d0ebe0a4806a17abc25a575f4f1ad7a50fb4f210810cac26e32f
|
File details
Details for the file qdiv-4.1.0-py3-none-any.whl.
File metadata
- Download URL: qdiv-4.1.0-py3-none-any.whl
- Upload date:
- Size: 711.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.15
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3468c7d0146b21377fe685956cdd0427b46bbcdaa3e7f8319a7eff926fc5cb1e
|
|
| MD5 |
03abf7b83d827794b983db1e1edc2cbc
|
|
| BLAKE2b-256 |
9a227abbde0c41611b47f5e5ed599cccc6f6114c754ae5f492c05aa021403df6
|
