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
Metadata
1 maintainer
Release files for qdiv 4.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qdiv-4.2.0.tar.gz | 691.8 kB | Without provenance | Details for qdiv-4.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| qdiv-4.2.0-py3-none-any.whl | Python 3 | none | any | Details for qdiv-4.2.0-py3-none-any.whl |
Total release size: 1.4 MB
Release files / qdiv-4.2.0.tar.gz
| Download URL | qdiv-4.2.0.tar.gz |
|---|---|
| Size | 691.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e82c75abe33ff659f4424d796c02e8c4e05922af1383abebc2b425f8dbab5fb2
|
|
BLAKE2b-256 checksum How to use checksums |
2f58337c98fe026d031883844db24f18c1078e627c9fef942022d36d5a2de826
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Release files / qdiv-4.2.0-py3-none-any.whl
| Download URL | qdiv-4.2.0-py3-none-any.whl |
|---|---|
| Size | 721.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6a06a41ebbc4899bbb345b2b9ca85c06b389fe65d81835ea82b32ad1b25788bb
|
|
BLAKE2b-256 checksum How to use checksums |
8b7b7adf59e80f973465aba9be9047fe88ca616d5ad513417daf1243e1d857b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Security for qdiv 4.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
