contMap {phytools}R Documentation

Map continuous trait evolution on the tree


Function plots a tree with a mapped continuous character. The mapping is accomplished by estimating states at internal nodes using ML with fastAnc, and the interpolating the states along each edge using equation [2] of Felsenstein (1985).


contMap(tree, x, res=100, fsize=NULL, ftype=NULL, lwd=4, legend=NULL,
	lims=NULL, outline=TRUE, sig=3, type="phylogram", direction="rightwards", 
	plot=TRUE, ...)
## S3 method for class 'contMap'
plot(x, ...)



object of class "phylo".


vector of phenotypic trait values for species. names(x) should contain the species names and match tree$tip.label. Or, for plot.contMap, an object of class "contMap".


resolution for gradient plotting. Larger numbers indicate a finer (smoother) gradient.


relative font size - can be a vector with the second element giving the font size for the legend.


font type - see options in plotSimmap. As with fsize, this can be a vector with the second element giving font type for the legend.


line width for branches.


if FALSE no legend is plotted; if a numeric value, it gives the length of the legend in units of branch length. Default is 0.5 times the total tree length.


range for the color map. By default, this will be c(min(x),max(x)), and should always include this range.


logical value indicating whether or not to outline the branches of the tree in black.


the number of decimal places to show on the legend limits.


type of plot desired. Options are "phylogram" for a rightward square phylogram; and "fan" for a circular phylogram.


plotting direction for type="phylogram".


logical value indicating whether or not to plot the tree. If plot=FALSE then an object of class "contMap" will be returned without plotting.


optional arguments for plot.contMap which include all the arguments of contMap except for tree, x, res, and lims. Also method, "fastAnc" or "anc.ML", specifying which function to use for ancestral state estimation; and hold specifies whether or not to hold output to graphical device before plotting (defaults to hold=TRUE).


Plots a tree. An object of class "contMap" is returned invisibly.


Liam Revell


Felsenstein, J. 1985. Phylogenies and the comparative method. American Naturalist, 125, 1-15.

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

Revell, L. J. 2013. Two new graphical methods for mapping trait evolution on phylogenies. Methods in Ecology and Evolution, 4, 754-759.

See Also

anc.ML, densityMap, fastAnc, plotSimmap

[Package phytools version 0.4-60 Index]