Skip to main content

taxburst: sunburst charts for taxonomy, based on Krona

PyPI install with bioconda

taxburst is a fork of the Krona software, (see: Ondov, Bergman, and Philippy, 2011). It produces static HTML pages that provide an interactive display of a metagenomic taxonomy.

Here is an example screenshot:

example output screenshot

Krona is a fantastic piece of software, but it has been unmaintained for a number of years. Moreover, the input parsing code is written in Perl and the default instructions require use of NCBI taxids.

The goal of taxburst is to update Krona to a maintained, documented piece of software that can be adapted and adjusted in a variety of ways. This is still alpha mode software, to be used at your own risk.

Please file bugs and feature requests on the issue tracker.

Pull requests are welcome!

Documentation

User and developer documentation is available at taxburst.github.io/taxburst/.

Examples

Here are some examples of (interactive!) taxburst plots:

Install

Via pypi

pip install taxburst

or from bioconda

conda create -n taxburst -c bioconda taxburst
conda activate taxburst

Example command lines

All data files are available in the GitHub repository under examples/.

Using sourmash tax metagenome output - summary_csv format

An example using the summary_csv format from sourmash tax metagenome (see tax metagenome docs),

taxburst examples/SRR11125891.summarized.csv \
    -o SRR11125891.summarized.html

then open SRR11125891.summarized.html in a browser.

Using sourmash tax annotate output

An example using the with-lineages format from sourmash tax annotate (see tax annotate docs

taxburst -F tax_annotate \
    examples/SRR11125891.t0.gather.with-lineages.csv \
    -o SRR11125891.tax_annotate.html

then open SRR11125891.tax_annotate.html in a browser.

Using singleM pipe output

An example using the profile format from singlem pipe (see singlem pipe docs):

taxburst -F singleM \
    examples/SRR11125891.singleM.profile.tsv \
    -o SRR11125891.singleM.html

then open SRR11125891.singleM.html in a browser.

Background and history

Krona is a super cool way to explore taxonomic breakdowns of metagenomes. But it's kind of old, and isn't being actively maintained. Moreover, it doesn't work easily with GTDB or other non-NCBI taxonomies.

So, why not grab the JavaScript code and rewrite the preprocessing code?

Voila! 'taxburst'!

I'd call it Krona2 or something, but the licensing for Krona prohibits that, to my understanding. Hence, 'taxburst'.

Citation information

When using taxburst, please cite the Krona paper: Interactive metagenomic visualization in a Web browser, Ondov et al., 2011.


CTB July 2025

ctbrown@ucdavis.edu

Metadata

Release files for taxburst 0.3.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for taxburst 0.3.2
File Size Uploaded
taxburst-0.3.2.tar.gz 65.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for taxburst 0.3.2
File Interpreter ABI Platform
taxburst-0.3.2-py3-none-any.whl Python 3 none any Details

Total release size: 127.9 kB

Release files / taxburst-0.3.2.tar.gz

Download URL taxburst-0.3.2.tar.gz
Size 65.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e13482312bb18c2f7cd7920f850fb6ee2dca21095cd15dc461f4c10dfd177217
BLAKE2b-256 checksum
How to use checksums
c27eb16d0d04f31cd53e8b3387fc9e4de5c0fea64f225088e1496c7a997ebd21
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.11.8

Release files / taxburst-0.3.2-py3-none-any.whl

Download URL taxburst-0.3.2-py3-none-any.whl
Size 62.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6a686efa0537c834573bd88a651d2897b0c04e5d09663488ad74794a24cc60cc
BLAKE2b-256 checksum
How to use checksums
0d2f7b762126a6d68e26f31f2ef7b1d3e60c67a4e647a98b8c39507a4803d83f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.11.8

Release history Release notifications | RSS feed

This release

0.3.2 This release

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page