phytools (version 0.7-70)

tree.grow: Creates an animation of a tree growing from left-to-right or upwards

Description

This function simulates a birth-death tree under user-defined conditions and then creates an animation of that tree growing from left-to-right in the plotting device, or upwards.

Usage

tree.grow(..., res=200, direction="rightwards", ladderize=TRUE)

Arguments

...

arguments to pass to pbtree.

res

number of steps (the resolution of the animation). This also corresponds to the number of frames that will be created if the animation is to be converted to a .gif file.

direction

the direction to plot the tree. Only direction="rightwards" (the default) and direction="upwards" are supported.

ladderize

logical value indicating whether or not to 'ladderize' the plotted tree. (Defaults to TRUE.)

Value

An object of class "phylo".

References

Revell, L. J. (2012) phytools: An R package for phylogenetic comparative biology (and other things). Methods Ecol. Evol., 3, 217-223.

See Also

pbtree

Examples

# NOT RUN {
## to create a .gif with ImageMagick installed
png(file="pbtree-<!-- %03d.png",width=1000,height=600,res=144) -->
tree.grow(b=0.06,d=0.02,t=100)
dev.off()
system("ImageMagick convert -delay 5 -loop 0 *.png pbtree-anim.gif")
# }