This function uses Bayesian MCMC to fit the quantitative genetics threshold model (Felsenstein 2012) to data for two discrete characters or one discrete and one continuous character.
threshBayes(tree, X, types=NULL, ngen=10000, control=list(), ...)
an object of class "phylo"
.
a numeric matrix containing values for a numerically coded discrete character and a continuous character; or two discrete characters. The row names of X
should be species names. Discrete characters need to be provided as numeric values of 0
or 1
and only binary traits are permitted.
a vector of length ncol(X)
containing the data types for each column of X
, for instance c("discrete","continuous")
.
a integer indicating the number of generations for the MCMC.
a list of control parameters for the MCMC. Control parameters include: sample
, the sampling interval for the MCMC; propvar
, a vector containing (in this order) proposal variances for the two rates (if the type is "discrete"
this will be ignored), the two ancestral states, and the correlation; propliab
, a single proposal variance for the liabilities; pr.mean
, a vector for the mean of the prior probability distributions for each parameter, in the same order as propvar
; pr.liab
, currently ignored; pr.var
, a vector with variances for the prior densities for each parameter, in the same order as pr.mean
- note that for the rates we use an exponential distribution so the first two means are currently ignored; and pr.vliab
currently ignored.
other optional arguments.
This function returns an object of class "threshBayes"
consisting of a list with at least the following two elements: par
a matrix containing the posterior sample for the model parameters (evolutionary rates, ancestral states, and correlation); liab
a matrix containing the posterior sample of the liabilities. For continuous characters, the liabilities are treated as known and so the posterior samples are just the observed values.
The plot
method for the object class "threshBayes"
can be used to plot a posterior density of the correlation coefficient, r.
Discrete characters must be binary, coded as 0
and 1
.
Felsenstein, J. (2012) A comparative method for both discrete and continuous characters using the threshold model. American Naturalist, 179, 145-156.
Revell, L. J. (2012) phytools: An R package for phylogenetic comparative biology (and other things). Methods Ecol. Evol., 3, 217-223.
Revell, L. J. (2014) Ancestral character estimation under the threshold model from quantitative genetics. Evolution, 68, 743-759.