R: Leaf label interchange

LeafLabelInterchange {TreeTools} | R Documentation

## Leaf label interchange

### Description

`LeafLabelInterchange()` exchanges the position of leaves within a tree.

### Usage

    LeafLabelInterchange(tree, n = 2L)

### Arguments

`tree` | A tree of class `phylo`.
`n` | Integer specifying number of leaves whose positions should be exchanged.

### Details

Modifies a tree by switching the positions of n leaves. To avoid later swaps undoing earlier exchanges, all n leaves are guaranteed to change position. Note, however, that no attempt is made to avoid swapping equivalent leaves, for example, a pair that are each others' closest relatives. As such, the relationships within a tree are not guaranteed to be changed.

### Value

`LeafLabelInterchange()` returns a tree of class `phylo` on which the position of `n` leaves have been exchanged. The tree's internal topology will not change.

### Author(s)

Martin R. Smith (martin.smith@durham.ac.uk)

### See Also

Other tree manipulation: `AddTip()`, `CollapseNode()`, `ConsensusWithout()`, `DropTip()`, `EnforceOutgroup()`, `MakeTreeBinary()`, `RenumberTips()`, `RenumberTree()`, `Renumber()`, `RootTree()`, `SingleTaxonTree()`, `SortTree()`, `Subtree()`

### Examples

    tree <- PectinateTree(8)
    plot(LeafLabelInterchange(tree, 3L))

[Package TreeTools version 1.2.0 Index]