# Chapter 6 Visual Exploration of Phylogenetic Tree

The ggtree supports many ways of manipulating the tree visually, including viewing selected clade to explore large tree (Figure 6.1), taxa clustering (Figure 6.5), rotating clade or tree (Figure 6.6B and 6.8), zoom out or collapsing clades (Figure 6.3A and 6.2), etc.. Details tree manipulation functions are summarized in Table 6.1.

Table 6.1: Tree manipulation functions.
Function Descriptiotn
flip exchange position of 2 clades that share a parent node
groupOTU grouping OTUs by tracing back to most recent common ancestor
identify interactive tree manipulation
rotate rotating a selected clade by 180 degree
rotate_tree rotating circular layout tree by specific angle
open_tree convert a tree to fan layout by specific open angle

A clade is a monophyletic group that contains a single ancestor and all of its descendants. We can visualize a specific selected clade via the viewClade function as demonstrated in Figure 6.1B. Another similar function is gzoom which plots the tree with selected clade side by side. These two functions are developed to explore large tree.

library(ggtree)
nwk <- system.file("extdata", "sample.nwk", package="treeio")
p <- ggtree(tree) + geom_tiplab()
viewClade(p, MRCA(p, "I", "L"))

Some of the functions, e.g. viewClade, work with clade and accept a parameter of internal node number. To get the internal node number, user can use MRCA() function (as in Figure 6.1) by providing two taxa names. The function will return node number of input taxa’s most recent commond ancestor (MRCA). It works with tree and graphic (i.e. ggtree() output) object. tidytree also provide MRCA function to extract information of MRCA node (see details in session 2.1.3).

The ggtree provides another option to zoom out (or compress) these clades via the scaleClade function. In this way, we retain the topology and branch lengths of compressed clades. This helps to save the space to highlight those clades of primary interest to the study.

tree2 <- groupClade(tree, c(17, 21))
p <- ggtree(tree2, aes(color=group)) + theme(legend.position='none') +
scale_color_manual(values=c("black", "firebrick", "steelblue"))
scaleClade(p, node=17, scale=.1) 

If users want to emphasize important clades, they can use scaleClade function with scale parameter larger than 1. Then the selected clade will be zoomed in. Users can also use groupClade to select clades and color them with different colors as shown in Figure 6.2.

## 6.3 Collapsing and Expanding Clade

It is a common practice to prune or collapse clades so that certain aspects of a tree can be emphasized. The ggtree supports collapsing selected clades using the collapse function as shown in Figure 6.3A.

p2 <- p %>% collapse(node=21) +
geom_point2(aes(subset=(node==21)), shape=21, size=5, fill='green')
p2 <- collapse(p2, node=23) +
geom_point2(aes(subset=(node==23)), shape=23, size=5, fill='red')
print(p2)
expand(p2, node=23) %>% expand(node=21)

Here two clades were collapsed and labelled by green circle and red square symbolic points. Collapsing is a common strategy to collapse clades that are too large for displaying in full or are not primary interest of the study. In ggtree, we can expand (i.e., uncollapse) the collapsed branches back with expand function to show details of species relationships as demonstrated in Figure 6.3B.

Triangles are often used to represent the collapsed clade and ggtree also supports it. The collapse function provides a “mode” parameter, which by default is “none” and the selected clade was collapsed as a “tip”. User can specify mode to “max” (Figure 6.4A), “min” (Figure 6.4B) and “mixed” (Figure 6.4C).

p2 <- p + geom_tiplab()
node <- 21
collapse(p2, node, 'max') %>% expand(node)
collapse(p2, node, 'min') %>% expand(node)
collapse(p2, node, 'mixed') %>% expand(node)

We can pass additional parameter to set the color and transparency of the triangles (Figure 6.4D).

collapse(p, 21, 'mixed', fill='steelblue', alpha=.4) %>%
collapse(23, 'mixed', fill='firebrick', color='blue')

We can combine scaleClade with collapse to zoom in/out of the triangles (Figure 6.4E).

scaleClade(p, 23, .2) %>% collapse(23, 'min', fill="darkgreen")  

## 6.4 Grouping Taxa

The groupClade function assigns the branches and nodes under different clades into different groups. groupClade accepts an internal node or a vector of internal nodes to cluster clade/clades.

Similarly, groupOTU function assigns branches and nodes to different groups based on user-specified groups of operational taxonomic units (OTUs) that are not necessarily within a clade, but can be monophyletic (clade), polyphyletic or paraphyletic. It accepts a vector of OTUs (taxa name) or a list of OTUs and will trace back from OTUs to their most recent common ancestor (MRCA) and cluster them together as demonstrated in Figure 6.5.

A phylogenetic tree can be annotated by mapping different line type, size, color or shape to the branches or nodes that have been assigned to different groups.

data(iris)
rn <- paste0(iris[,5], "_", 1:150)
rownames(iris) <- rn
d_iris <- dist(iris[,-5], method="man")

tree_iris <- ape::bionj(d_iris)
grp <- list(setosa     = rn[1:50],
versicolor = rn[51:100],
virginica  = rn[101:150])

p_iris <- ggtree(tree_iris, layout = 'circular', branch.length='none')
groupOTU(p_iris, grp, 'Species') + aes(color=Species) +
theme(legend.position="right")

We can grouping taxa at tree level. The following code will produce identical figure of Figure 6.5 (see more details described at session 2.2.3).

tree_iris <- groupOTU(tree_iris, grp, "Species")
ggtree(tree_iris, aes(color=Species), layout = 'circular', branch.length = 'none') +
theme(legend.position="right")

## 6.5 Exploring tree structure

To facilitate exploring the tree structure, ggtree supports rotating selected clade by 180 degree using the rotate function (Figure 6.6B). Position of immediate descendant clades of internal node can be exchanged via flip function (Figure 6.6C).

p1 <- p + geom_point2(aes(subset=node==16), color='darkgreen', size=5)
p2 <- rotate(p1, 17) %>% rotate(21)
flip(p2, 17, 21)

Most of the tree manipulation functions are working on clades, while ggtree also provides functions to manipulate a tree, including open_tree to transform a tree in either rectangular or circular layout to fan layout, and rotate_tree function to rotate a tree for specific angle in both circular or fan layouts, as demonstrated in Figure 6.7 and 6.8.

p3 <- open_tree(p, 180) + geom_tiplab()
print(p3)
rotate_tree(p3, 180)

The following example traverse all the internal nodes and rotate them one by one (Figure 6.9).

set.seed(2016-05-29)
x <- rtree(50)
p <- ggtree(x) + geom_tiplab()
for (n in reorder(x, 'postorder')\$edge[,1] %>% unique) {
p <- rotate(p, n)
print(p + geom_point2(aes(subset=(node == n)), color='red'))
}
set.seed(123)
tr <- rtree(50)
p <- ggtree(tr, layout='circular') + geom_tiplab()

for (angle in seq(0, 270, 10)) {
print(open_tree(p, angle=angle) + ggtitle(paste("open angle:", angle)))
}

Figure 6.10 demonstrates the usage of open_tree with different open angles.

Figure 6.11 illustrates rotating tree with different angles.

for (angle in seq(0, 270, 10)) {
print(rotate_tree(p, angle) + ggtitle(paste("rotate angle:", angle)))
}

Interactive tree manipulation is also possible via identify methods14.

## 6.6 Summary

The ggtree provides a set of functions to allow visually manipulating phylogenetic tree and exploring tree structure with associated data.