General Purpose Hierarchical Data Structure for R
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

CRAN: CRAN Version CRAN downloads

Master: Build Status master Windows Build status

Dev: Build Status dev Windows Build status


An R package to manage hierarchical data and tree structures

Hierarchical data is ubiquitous in statistics and programming (XML, search trees, family trees, classification, file system, etc.). However, no general-use tree data structure is available in base R. Where tabular data has data.frame, hierarchical data is often modeled in lists of lists or similar makeshifts. These structures are often difficult to manage. This is where the data.tree package steps in. It lets you build trees of hierarchical data for various uses: to print, plot and visualize, to generate breakdowns, to integrate with html widgets, to rapid prototype search algorithms, to test out new classification ideas, and much more.

Tree structures can be created programmatically, or by conversion. The package provides functionality to convert from and to various formats such as data.frames, list of lists, dendrograms, partykit, ape phylo, igraph, JSON, YAML, and more.

Learn More

To get started, you might want to read the introduction vignette. There is also a vignette containing some examples and applications.

The manual is here

Finally, you'll find more examples and background information on my blog.


The latest from github dev branch may have some breaking changes compared to CRAN. See NEWS for details.


Coding Conventions: Google Style Guide, see

Versioning Conventions: SemanticVersioning. See for details

Branching Conventions: GitFlow. See

Pull Requests: Very welcome! Please branch from the dev branch.