Learn R Programming

An R interface to the NEXUS Class Library

This R package provides an interface to the C++ library NCL. It can parse efficiently common file formats used to store phylogenetic trees, especially NEXUS and Newick files.

This package is primarily intended to be used by package developers as it extracts the elements needed to build R objects that represent the content of the file. For instance, phylobase uses rncl to extract trees and/or data stored in NEXUS and Newick files to create objects of class phylo4 or phylo4d.

The package however provides two functions for users: read_nexus_phylo() and read_newick_phylo(). They read NEXUS and Newick files respectively, and return (a valid) phylo or multiPhylo object from the package ape. These functions differ from those found in ape (respectively read.tree and read.nexus) as rncl functions can read trees with singletons, and missing branch lengths. However, rncl adheres to the NEXUS standards and only accepts tip labels without white spaces and tip labels cannot be duplicated in the same tree.

Development versions for Windows

Because this package contains some C++ code, it can be tricky to build if you are using Windows. Unless you need a feature only available on GitHub, install rncl from CRAN.

Otherwise, you can obtain a binary version from here (unless the AppVeyor badge on top is gray, in which case you can download an older version or come back in a few minutes, or red meaning the current version is broken and you need to get an older version). Once in appveyor, look for the file named rncl_X.Y.Z.zip where X.Y.Z represent the version number (e.g., rncl_0.4.0.zip). Then you can install this compiled version of the package directly from R.

Copy Link

Version

Install

install.packages('rncl')

Monthly Downloads

4,675

Version

0.8.7

License

BSD_2_clause + file LICENSE

Issues

Pull Requests

Stars

Forks

Last Published

January 8th, 2023

Functions in rncl (0.8.7)

read_nexus_phylo

Read phylogenetic trees from files
rncl

rncl: An R interface to the NEXUS Class Library