dendextend (version 0.14.2)

shuffle: Random rotation of trees

Description

'shuffle' randomilly rotates ("shuffles") a tree, changing its presentation while preserving its topolgoy. 'shuffle' is based on rotate and through its methods can work for any of the major tree objects in R (dendrogram/hclust/phylo). This function is useful in combination with tanglegram and entanglement.

Usage

shuffle(object, ...)

## S3 method for class 'dendrogram':
shuffle(object, ...)

## S3 method for class 'hclust':
shuffle(object, ...)

## S3 method for class 'phylo':
shuffle(object, ...)

Arguments

object

a tree object (dendrogram/hclust/phylo)

...

Ignored.

Value

• A randomlly rotated tree object

Details

'shuffle' is a function that randomilly rotates ("shuffles") a tree. a dendrogram leaves order (by means of rotation)

See Also

tanglegram, entanglement, rotate

Examples

dend <- as.dendrogram(hclust(dist(USArrests)))
set.seed(234238)
dend2 <- shuffle(dend)

tanglegram(dend, dend2, margin_inner=7)
entanglement(dend, dend2) # 0.3983

# although these ARE the SAME tree:
tanglegram(sort(dend), sort(dend2), margin_inner=7)