match.multiPhylo: Tree matching

In TreeTools: Create, Modify and Analyse Phylogenetic Trees

Tree matching

Description

match() returns a vector of the positions of (first) matches of trees in its first argument in its second. %in% is a more intuitive interface as a binary operator, which returns a logical vector indicating whether there is a match or not for each tree in its left operand.

Usage

## S4 method for signature 'phylo,phylo'
match(x, table, nomatch = NA_integer_, incomparables = NULL)

## S4 method for signature 'multiPhylo,phylo'
match(x, table, nomatch = NA_integer_, incomparables = NULL)

## S4 method for signature 'phylo,multiPhylo'
match(x, table, nomatch = NA_integer_, incomparables = NULL)

## S4 method for signature 'multiPhylo,multiPhylo'
match(x, table, nomatch = NA_integer_, incomparables = NULL)

## S4 method for signature 'multiPhylo,multiPhylo'
x %in% table

## S4 method for signature 'multiPhylo,phylo'
x %in% table

## S4 method for signature 'phylo,multiPhylo'
x %in% table

## S4 method for signature 'phylo,phylo'
x %in% table

Arguments

x, table	Object of class phylo or multiPhylo.
nomatch	Integer value that will be used in place of NA in the case where no match is found.
incomparables	Ignored. (Included for consistency with generic.)

Value

match() returns an integer vector specifying the position in table that matches each element in x, or nomatch if no match is found.

See Also

Corresponding base functions are documented in match().

Other utility functions: ClusterTable, ClusterTable-methods, Hamming(), MSTEdges(), SampleOne(), TipTimedTree(), UnshiftTree(), as.multiPhylo(), sapply64(), sort.multiPhylo()

Examples

tree1 <- BalancedTree(7)
trees <- c(PectinateTree(7), BalancedTree(7))

match(tree1, trees)

TreeTools documentation built on Aug. 8, 2025, 7:18 p.m.