plotCt: Plots calcConv or convSig output.

In convevol: Analysis of Convergent Evolution

Plots calcConv or convSig output.

Description

plotCt Plots calcConv or convSig output.

Usage

plotCt(
  output,
  phy,
  focaltaxa,
  nsim = 25,
  col = c("black", "forest green", "dodgerblue2", "firebrick1", "purple", "orange",
    "salmon", "goldenrod", "springgreen2", "plum1"),
  groups = NULL,
  ...
)

Arguments

output	object containing calcConv or convSig output
phy	The time calibrated phylogeny of interest in phylo format
focaltaxa	a vector of tip labels for the putatively convergent taxa to be compared
nsim	number of null simulations to plot
col	vector of colors to use for all unique intergroup comparisons a default option is given usable with up to five groups. If number of groups is 1 or less than length of col, not all colors will be used
groups	an optional vector of groups with names matching focaltaxa, indicating the group identity of all focaltaxa
...	optional arguments to be passed to tiplabels

Details

Creates a plot that shows the phenotypic distances between pairs of putatively convergent lineages over time. When these distances decrease, convergence has occurred. When more than two putatively convergent taxa are analyzed, all pairs are plotted.

Value

A plot identifying putatively convergent taxa in the provided phylogeny and tracking the change in phenotypic distance between taxa since their most recent common ancestor

References

Grossnickle DM, Brightly WH, Weaver LN, Stanchak KE, Roston RA, Pevsner SK, Stayton CT, Polly PD, Law CJ. 2022. A cautionary note on quantitative measures of phenotypic convergence. in revision Zelditch ML, Ye J, Mitchell JS, Swiderski DL. 2017. Rare ecomorphological convergence on a complex adaptive landscape: Body size and diet mediate evolution of jaw shape in squirrels (Sciuridae). Evolution 71: 633-649 Stayton CT. 2015. The definition, recognition, and interpretation of convergent evolution and two new measures for quantifying and assessing the significance of convergence. Evolution 69(8): 2140-2153. Revell, L. J. (2012) phytools: An R package for phylogenetic comparative biology (and other things). Methods Ecol. Evol., 3, 217-223. Felsenstein, J. 1985. Phylogenies and the comparative method. American Naturalist, 125, 1-15.

convevol documentation built on July 9, 2023, 5:07 p.m.