ape (version 5.8-1)

is.binary: Test for Binary Tree

Description

This function tests whether a phylogenetic tree is binary.

Usage

is.binary(phy)
# S3 method for phylo
is.binary(phy)
# S3 method for multiPhylo
is.binary(phy)
# S3 method for tree
is.binary(phy)

Value

a logical vector.

Arguments

phy

an object of class "phylo" or "multiPhylo".

Author

Emmanuel Paradis

Details

The test differs whether the tree is rooted or not. An urooted tree is considered binary if all its nodes are of degree three (i.e., three edges connect to each node). A rooted tree is considered binary if all nodes (including the root node) have exactly two descendant nodes, so that they are of degree three expect the root which is of degree 2.

The test ignores branch lengths. Consider using di2multi if you want to treat zero-branch lengths as resulting from multichotomies.

is.binary.tree is deprecated and will be removed soon: currently it calls is.binary.

See Also

is.rooted, is.ultrametric, multi2di

Examples

is.binary(rtree(10))
is.binary(rtree(10, rooted = FALSE))
is.binary(stree(10))
x <- setNames(rmtree(10, 10), LETTERS[1:10])
is.binary(x)