TreeSwift: Fast tree module for Python 2 and 3


Keywords
tree, phylogenetics, fast
Licenses
GPL-3.0/GPL-3.0+
Install
pip install treeswift==1.1.42

Documentation

TreeSwift

TreeSwift is a Python library for parsing, manipulating, and iterating over (rooted) tree structures. TreeSwift places an emphasis on speed.

Installation

TreeSwift can be installed using pip:

sudo pip install treeswift

If you are using a machine on which you lack administrative powers, TreeSwift can be installed locally using pip:

pip install --user treeswift

Usage

Typical usage should be as follows:

  1. Import the treeswift package
  2. Use treeswift.read_tree_newick to load your Newick tree
  3. Use the various Tree class functions on the resulting object as you need
import treeswift
tree = treeswift.read_tree_newick(my_newick_string)
for node in tree.traverse_postorder():
    print(node)

Full documentation can be found at https://niemasd.github.io/TreeSwift/, and more examples can be found in the TreeSwift Wiki.

Citing TreeSwift

If you use TreeSwift in your work, please cite:

Moshiri N (2020). "TreeSwift: a massively scalable Python package for trees." SoftwareX. 11:100436. doi:10.1016/j.softx.2020.100436