A Tidy Tool for Phylogenetic Tree Data Manipulation
Overview
Phylogenetic trees contain components such as nodes, edges, branches, and associated data. As the core data manipulation tool in the 'ggtree' ecosystem, 'tidytree' provides tools for converting tree objects to tidy data frames and tidy interfaces for manipulating, analyzing, and visualizing tree data.
- improve
tree_subset()error handling for unmatched nodes and passroot_edgeconsistently in thetreedatamethod (2026-07-02, Thu) - make malformed
tbl_treeobjects fail with a clear validation error when converted byas.phylo()(2026-07-02, Thu) - optimize
offspring()for 'phylo' objects andas.ultrametric()for large trees by avoiding repeated edge scans and vector growth in traversal loops (2026-07-02, Thu) - update package citation and documentation links (2026-07-02, Thu)
- remove duplicated rows in
ybeforeleft_join()andfull_join()to avoid duplicated annotation records after joining tables (2026-07-01, Wed, #52)
From NEWS.md in the release
Install
Health
NOTEdependencies in R coder-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64
r-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
Base package in Suggests/Enhances imported in NAMESPACE: ‘utils’
r-devel-windows-x86_64
Base package in Suggests/Enhances imported in NAMESPACE: 'utils'
- NOTE8 OK, 5 NOTENow
- NOTE11 OK, 2 NOTE2026-09-12
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK14 OK2026-03-10
Documentation
- Help pages
- 31 (2 internal)includes a package overview page
- Examples that run
- 100%9 run in a plain check
- Exported functions with examples
- 31%
- Documented parameters
- 100%
- Return-value docs
- 85%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 88%
- Median days to close, 50 most recently updated closed issues
- 4
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Issues over time
PRs over time
5 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/yulab-smu/tidytree on 2026-10-18.
GitHub Pages site last deployed 2017-12-13
Dependencies
Installing tidytree adds 27 packages (18 with compiled code, 23 MB of source tarballs). Heaviest: stringi 11 MB, Rcpp 1.8 MB, ape 1.4 MB.
Show all 15 packagesHide all 15 packages
Code & Tests
People & History
Pick two releases to compare their code metrics.
- 0.4.8Latest
- RR 4.6.0 released · 2026-04-24
- 0.4.72026-01-08 · diff ↗
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 0.4.62023-12-12 · diff ↗
- 0.4.52023-08-10 · diff ↗ ·
added 13 exports
Nnode, Ntip, as.ultrametric, drop.tip, get.treetext, getNodeNum, is.rooted, isTip, keep.tip, read.tree, root, rtree, tree_subset - 0.4.4
- RR 4.3.0 released · 2023-04-21
- 0.4.22022-12-18 · diff ↗
- 0.4.12022-09-26 · diff ↗
- 0.4.02022-08-13 · diff ↗
- RR 4.2.0 released · 2022-04-22
- 0.3.92022-03-04 · diff ↗
- 0.3.82022-02-17 · diff ↗
- 0.3.72022-01-10 · diff ↗
Show 26 earlier eventsHide 26 earlier events
- 0.3.62021-11-12 · diff ↗
- 0.3.5
- 0.3.4
- RR 4.1.0 released · 2021-05-18
- RR 4.0.0 released · 2020-04-24
- 0.3.3
- 0.3.22020-03-12 · diff ↗
- 0.3.12019-12-14 · diff ↗
- 0.3.02019-11-21 · diff ↗
- 0.2.92019-10-28 · diff ↗
- 0.2.82019-09-27 · diff ↗
- 0.2.72019-09-12 · diff ↗
- 0.2.6
- 0.2.52019-07-22 · diff ↗
- RR 3.6.0 released · 2019-04-26
- 0.2.42019-02-27 · diff ↗
- 0.2.32019-01-30 · diff ↗
- 0.2.12018-12-19 · diff ↗
- 0.2.0
- 0.1.92018-06-13 · diff ↗
- RR 3.5.0 released · 2018-04-23
- 0.1.82018-04-19 · diff ↗
- 0.1.7
- 0.1.6
- 0.1.52017-12-14
- RR 3.4.0 released · 2017-04-21
Package metadata
- First published
- 2017-12-14
- Total releases
- 32 / 9 yrs
- License
- Artistic-2.0 OSI
- Minimum R
- ≥ 3.4.0
- Download size
- 37 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("tidytree")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.1201/9781003279242.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.