BAMMtools (version 2.1.0)

dtRates: Calculate macroevolutionary rate changes on a phylogeny from BAMM output

Description

dtRates calculates the mean of the marginal posterior density of the rate of speciation/extinction or trait evolution for small segments along each branch in a phylogeny.

Usage

dtRates(ephy, tau, ism = NULL, tmat = FALSE)

Arguments

ephy

an object of class bammdata.

tau

a numeric that specifies the size (as a fraction of tree height) of the segments that each branch will be discretized into.

ism

an integer vector indexing which posterior samples to include in the calculation.

tmat

a logical. If TRUE the matrix of branch segments is returned.

Value

• A bammdata object with a new component named "dtrates", which is a list with two or three components:
• tau
  the parameter value of tau used in the calculation.
• rates
  if ephy$type = "trait": a numeric vector with the phenotypic rates of each segment on each branch. if ephy$type = "diversification": a list with two components. The first component is a numeric vector of speciation rates. The second component is a numeric vector of extinction rates.
• tmat
  a matrix of the starting and ending times of the segments on each branch. Only if tmat = TRUE.

Details

dtRates bins the phylogeny into windows of time and calculates average rates of speciation/extinction or phenotypic evolution along each segment of a branch within a window. The width of each window is determined by tau. tau is a fraction of the root to tip distance so a value of tau = 0.01 bins the phylogeny into 100 time windows of equal width.

References

bamm-project.org

See Also

plot.bammdata

Examples

data(whales, events.whales)
ed <- getEventData(whales, events.whales, burnin=0.25, nsamples=500)

#use all posterior samples
ed <- dtRates(ed, tau=0.01)

#use specified range of posterior samples
ed <- dtRates(ed, tau=0.01, ism=50:150)