arxiv: 2605.01109 · v1 · submitted 2026-05-01 · 🧬 q-bio.PE

Recognition: unknown

Heat-tree: Cross-platform software for interactive and embeddable phylogenetic tree visualization and editing

Jeff H. Chang, Niklaus J. Grunwald, Zachary S.L. Foster

Authors on Pith no claims yet

Pith reviewed 2026-05-09 14:15 UTC · model grok-4.3

classification 🧬 q-bio.PE

keywords phylogenetic treevisualizationinteractive editingR packagePython packageJavaScriptmetadata encodingevolutionary biology

0 comments

The pith

Heat-tree is a collection of packages in JavaScript, R, and Python for creating interactive phylogenetic tree visualizations with editing and metadata encoding that embed across documents and websites.

A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.

Phylogenetic trees are the main framework for showing evolutionary relationships, but most existing visualization tools produce only static images, demand coding knowledge, or are locked to one website. The paper describes heat-tree as software packages that generate customizable visualizations supporting radial and rectangular layouts. These can be placed directly into R Markdown files, Jupyter Notebooks, Quarto documents, HTML pages, or web applications. Metadata values are translated automatically into visual features on the tree, users can edit the tree through a graphical interface, and publication-quality figures can be exported. The approach matters for researchers who need to examine, adjust, and share evolutionary data in reproducible documents without extra setup steps.

Core claim

Heat-tree is a collection of software packages in JavaScript, R, and Python for the interactive visualization, manipulation, and editing of phylogenetic trees and their associated metadata. It supports radial and rectangular layouts, automated translation of metadata values into visual encodings, interactive tree editing, and export of publication-quality figures, with all visualization parameters controllable either programmatically or through a comprehensive graphical user interface. The resulting visualizations are web-compatible and embeddable in R Markdown, Jupyter Notebooks, Quarto documents, and direct HTML or JavaScript applications and websites.

What carries the argument

heat-tree, the cross-platform collection of packages that renders trees in radial or rectangular layouts, converts metadata into visual encodings, supplies a graphical interface for parameter changes and edits, and produces self-contained outputs for embedding.

If this is right

Researchers can include editable phylogenetic trees directly inside reproducible documents such as Jupyter Notebooks and R Markdown files.
Metadata linked to tree tips or branches can be turned into visual features automatically rather than through manual scripting.
Users can adjust visualization settings through a graphical interface and then export publication-quality figures.
The same tree visualization can be reused across R, Python, and web-based applications without rewriting code.
Parameters for layout, encoding, and editing can be defined either by code or by interacting with the included graphical user interface.

Where Pith is reading between the lines

These are editorial extensions of the paper, not claims the author makes directly.

The embeddable format could reduce friction when moving phylogenetic results between analysis scripts and final reports or presentations.
Automatic metadata encoding might encourage more consistent visual comparison of tree traits across different studies.
The design of a unified package for multiple languages suggests it could serve as a base for community additions such as new layout options.

Load-bearing premise

That the cross-platform embedding, interactive editing, metadata auto-encoding, and graphical interface work as described in target environments without users needing to install or maintain extra dependencies.

What would settle it

Embedding a tree with metadata into a Jupyter Notebook or R Markdown document using heat-tree, performing edits through the graphical interface, and verifying that the visualization renders interactively and exports without additional installations or errors.

Figures

Figures reproduced from arXiv: 2605.01109 by Jeff H. Chang, Niklaus J. Grunwald, Zachary S.L. Foster.

**Figure 1.** Figure 1: Interactive phylogenetic tree visualization produced with heat-tree implemented in JavaScript. Here, tip label color is determined by a column with categorical data and tip label size is determined by a column with continuous numerical data. Colors and sizes used are automatically determined view at source ↗

read the original abstract

Phylogenetic trees are the primary framework for conveying evolutionary relationships. While many tools exist for visualizing phylogenetic trees, most are limited to static graphics, require coding expertise, or are developed for a specific website and not easily reusable or extensible. To address these limitations, we developed heat-tree, a collection of software packages in JavaScript, R, and Python for interactive visualization, manipulation, and editing of phylogenetic trees and their associated metadata. Heat-tree allows for the creation of customizable, web-compatible tree visualizations that can be easily embedded in R Markdown, Jupyter Notebooks, and Quarto documents, as well as directly in HTML/JavaScript applications and websites. The package supports radial and rectangular tree layouts, automated translation of metadata values into visual encodings on the tree, interactive tree editing, and export capabilities for publication-quality figures. All visualization parameters are definable programmatically or interactively using the comprehensive graphical user interface included with each visualization. Heat-tree was designed to be a user-friendly software package for interactive tree viewing, manipulation, editing, and self-contained, embeddable visualization across software environments.

Editorial analysis

A structured set of objections, weighed in public.

Desk editor's note, referee report, simulated authors' rebuttal, and a circularity audit. Tearing a paper down is the easy half of reading it; the pith above is the substance, this is the friction.

Desk Editor's Note private letter to a colleague

Heat-tree is a multi-language package for interactive phylogenetic tree editing and embedding, but the paper is mostly a feature list without benchmarks or code checks.

read the letter

The main takeaway is that the authors released heat-tree as a set of packages in JavaScript, R, and Python for building interactive phylogenetic trees that embed cleanly into notebooks and web pages, with built-in editing and metadata mapping to visuals like colors or sizes. It supports radial and rectangular layouts plus a GUI so users can tweak things without constant coding. That combination of cross-platform support and self-contained output is the practical angle they highlight. The description lines up with common complaints about static plots or tools locked to one site or language. They get credit for trying to make something reusable across R Markdown, Jupyter, and plain HTML. The GUI for interactive editing and auto-encoding of metadata is a reasonable addition for daily use. The paper stays coherent on its own terms and does not rely on any circular math or hidden assumptions that would collapse the argument. The soft spot is that everything rests on the claim that the features work as described. There are no usage examples, no timing or memory benchmarks, and no direct comparison to tools like ggtree, iTOL, or existing JavaScript tree viewers. Without the actual code or a demo that shows the embedding stays lightweight and the editing does not break metadata links, it is hard to judge whether the stated limitations are really solved. This is aimed at researchers who produce and share trees as part of routine analysis and want something that travels into reports or websites without extra setup. A methods or bioinformatics reader who values workflow tools would get the most out of it. It deserves a serious referee because software papers can matter when the implementation is solid and the feature set fills a real gap. I would send it to review but ask the authors to include the repository link, a couple of concrete notebook examples, and at least a short table comparing key capabilities to two or three existing packages.

Referee Report

1 major / 1 minor

Summary. The manuscript describes the development of heat-tree, a collection of software packages in JavaScript, R, and Python for interactive visualization, manipulation, and editing of phylogenetic trees and associated metadata. It claims to address limitations of existing tools by supporting customizable web-compatible visualizations embeddable in R Markdown, Jupyter Notebooks, Quarto, and HTML/JS applications; radial and rectangular layouts; automated translation of metadata into visual encodings; interactive editing; export of publication-quality figures; and a comprehensive GUI for defining parameters.

Significance. If the released packages function as described, heat-tree would provide a practical cross-platform solution for phylogenetic tree handling that integrates well with modern reproducible workflows. The multi-language implementation and emphasis on embeddability without heavy external dependencies represent a clear strength for accessibility in evolutionary biology and related fields.

major comments (1)

[Abstract] Abstract: the central claim that heat-tree overcomes the stated limitations of prior tools (static graphics, coding requirements, platform specificity) rests solely on descriptive assertions without any code snippets, usage examples, screenshots, benchmarks, or comparisons to existing packages such as ggtree or iTOL. This absence is load-bearing because the contribution is a software package whose value cannot be assessed from description alone.

minor comments (1)

The abstract and manuscript would be strengthened by including at least one concrete usage example or installation command to illustrate the claimed cross-platform embedding.

Simulated Author's Rebuttal

1 responses · 0 unresolved

We thank the referee for the constructive feedback on our manuscript. We address the major comment below and will make the requested revisions to strengthen the abstract.

read point-by-point responses

Referee: [Abstract] Abstract: the central claim that heat-tree overcomes the stated limitations of prior tools (static graphics, coding requirements, platform specificity) rests solely on descriptive assertions without any code snippets, usage examples, screenshots, benchmarks, or comparisons to existing packages such as ggtree or iTOL. This absence is load-bearing because the contribution is a software package whose value cannot be assessed from description alone.

Authors: We agree that the abstract would be strengthened by moving beyond purely descriptive claims. In the revised manuscript we will expand the abstract to include (1) a brief usage example of embedding an interactive visualization in a Jupyter Notebook or R Markdown document, (2) explicit mention of the supported radial/rectangular layouts and metadata-to-visual-encoding automation, and (3) a concise side-by-side comparison with ggtree and iTOL that highlights heat-tree’s cross-platform embeddability and GUI-driven parameter setting. The main text already contains code snippets, screenshots, and feature comparisons; we will add forward references to these elements within the abstract itself. We believe these changes will allow readers to assess the contribution directly from the abstract while preserving its length constraints. revision: yes

Circularity Check

0 steps flagged

No significant circularity

full rationale

This is a software description paper presenting heat-tree packages for phylogenetic tree visualization, editing, and embedding across JavaScript, R, and Python. It contains no derivations, equations, fitted parameters, predictions, or uniqueness theorems. All claims concern implemented features (layouts, metadata encoding, GUI, export) whose validity is external to the manuscript and does not reduce to any self-referential construction or self-citation chain within the text. The central contribution is the release and documentation of code, which is self-contained against external benchmarks.

Axiom & Free-Parameter Ledger

0 free parameters · 0 axioms · 0 invented entities

This is a software development paper with no mathematical derivations, fitted parameters, or postulated physical entities. The central claim rests on the existence and functionality of the described code packages.

pith-pipeline@v0.9.0 · 5497 in / 1113 out tokens · 38001 ms · 2026-05-09T14:15:39.517684+00:00 · methodology

discussion (0)

Reference graph

Works this paper leans on

10 extracted references · 9 canonical work pages

[1]

PLOS Computational Biology 13:e1005404

Metacoder: An R package for visualization and manipulation of community taxonomic diversity data. PLOS Computational Biology 13:e1005404. https://doi.org/10.1371/journal.pcbi.1005404. Foster, Z. S. L., Sudermann, M. A., Parada-Rojas, C., Blair, L. K., Fernanda Iruegas-Bocardo, Dhakal, U., Alcalá-Briseño, R. I., Weisberg, A. J., Phan, H., Schummer, T. R., ...

work page doi:10.1371/journal.pcbi.1005404
[2]

bioRxiv 2025.10.31.685798

PathogenSurveillance: an automated pipeline for population genomic analyses and pathogen identification. bioRxiv 2025.10.31.685798. https://doi.org/10.1101/2025.10.31.685798. Huson, D. H., and Scornavacca, C

work page doi:10.1101/2025.10.31.685798 2025
[3]

Systematic Biology 61:1061–1067

Dendroscope 3: An Interactive Tool for Rooted Phylogenetic Trees and Networks. Systematic Biology 61:1061–1067. https://doi.org/10.1093/sysbio/sys062. Letunic, I., and Bork, P

work page doi:10.1093/sysbio/sys062
[4]

Nucleic Acids Research 49:W293–W296

Interactive Tree Of Life (iTOL) v5: an online tool for phylogenetic tree display and annotation. Nucleic Acids Research 49:W293–W296. https://doi.org/10.1093/nar/gkab301. Paradis, E., and Schliep, K

work page doi:10.1093/nar/gkab301
[5]

Russell Schwartz

ape 5.0: an environment for modern phylogenetics and evolutionary analyses in R ed. Russell Schwartz. Bioinformatics 35:526–528. https://doi.org/10.1093/bioinformatics/bty633. Rambaut, A

work page doi:10.1093/bioinformatics/bty633
[6]

Methods in Ecology and Evolution 3:217–223

phytools: an R package for phylogenetic comparative biology (and other things): phytools: R package. Methods in Ecology and Evolution 3:217–223. https://doi.org/10.1111/j.2041-210X.2011.00169.x. Weisberg, A. J., Davis, E. W., Tabima, J., Belcher, M. S., Miller, M., Kuo, C.-H., Loper, J. E., Grünwald, N. J., Putnam, M. L., and Chang, J. H

work page doi:10.1111/j.2041-210x.2011.00169.x 2041
[7]

Science 368:eaba5256

Unexpected conservation and global transmission of agrobacterial virulence plasmids. Science 368:eaba5256. https://doi.org/10.1126/science.aba5256. Wickham, H

work page doi:10.1126/science.aba5256
[8]

In ggplot2, Use R!, Cham: Springer International Publishing, pp

Getting Started with ggplot2. In ggplot2, Use R!, Cham: Springer International Publishing, pp. 11–31. https://doi.org/10.1007/978-3-319-24277-4_2. Yu, G., Smith, D. K., Zhu, H., Guan, Y ., and Lam, T. T

work page doi:10.1007/978-3-319-24277-4_2
[9]

Greg McInerny

ggtree: an R package for visualization and annotation of phylogenetic trees with their covariates and other associated data ed. Greg McInerny. Methods Ecol Evol 8:28–36. https://doi.org/10.1111/2041-210X.12628. Figures Figure

work page doi:10.1111/2041-210x.12628 2041
[10]

The tree depicts currently recognized species within the Agrobacterium- Rhizobium complex based on the published MLSA maximum‑likelihood phylogeny (Weisberg et al

Example heat-tree implementation in R for interactive, phylogenetic tree visualization. The tree depicts currently recognized species within the Agrobacterium- Rhizobium complex based on the published MLSA maximum‑likelihood phylogeny (Weisberg et al. 2020), with strain identifiers shown as tip labels and host type encoded by tip label color. A scale bar ...

2020