\name{evol.rate.mcmc}
\alias{evol.rate.mcmc}
\alias{print.evol.rate.mcmc}
\alias{summary.evol.rate.mcmc}
\alias{print.summary.evol.rate.mcmc}
\alias{plot.summary.evol.rate.mcmc}
\title{Bayesian MCMC method for identifying exceptional phenotypic diversification in a phylogeny}
\usage{
evol.rate.mcmc(tree, x, ngen=10000, control=list(), ...)
\method{print}{evol.rate.mcmc}(x, ...)
\method{summary}{evol.rate.mcmc}(object, ...)
\method{print}{summary.evol.rate.mcmc}(x, ...)
\method{plot}{summary.evol.rate.mcmc}(x, ...)
}
\arguments{
	\item{tree}{an object of class \code{"phylo"} (a phylogenetic tree).}
	\item{x}{a vector of tip values for species in which \code{names(x)} contains the species names of \code{tree}, an object of class \code{"evol.rate.mcmc"}, or (in the case of the S3 \code{summary} method) an object of class \code{"summary.evol.rate.mcmc"}.}
	\item{ngen}{an integer value indicating the number of generations for the MCMC.}
	\item{control}{a list of control parameters containing the following elements: \code{sig1}: starting value for \eqn{\sigma_1^2}; \code{sig2}: starting value for \eqn{\sigma_2^2}; \code{a}: starting value for a; \code{sd1}: standard deviation for the normal proposal distribution for \eqn{\sigma_1^2}; \code{sd2}: standard deviation for the normal proposal distribution for \eqn{\sigma_2^2}; \code{kloc}: scaling parameter for tree move proposals - \eqn{1/\lambda} for the reflected exponential distribution; \code{sdlnr}: standard deviation on the log-normal prior on \eqn{\sigma_1^2/\sigma_2^2}; \code{rand.shift}: probability of proposing a random shift in the tree (improves mixing); \code{print}: print frequency for the MCMC; \code{sample}: sample frequency.}
	\item{object}{for the S3 \code{summary} method, an object of class \code{"evol.rate.mcmc"}.}
	\item{...}{other optional arguments.}
}
\description{
	Estimates the phylogenetic location of a \emph{single} rate shift on the tree using Bayesian MCMC (as described in Revell et al., 2012b).
}
\details{
	This function takes a phylogenetic tree and data for a single continuously valued character and uses a Bayesian MCMC approach to identify the phylogenetic location of a shift in the evolutionary rate through time.

	Default values of \code{control} are given in Revell et al. (2012b).
}
\value{
	An object of class \code{"evol.rate.mcmc"} consisting of at least the following elements:
	\item{mcmc}{results from the MCMC run.}
	\item{tips}{list of tips in rate \eqn{\sigma_1^2} for each sampled generation of MCMC (to polarize the rate shift).}
}
\references{
	Revell, L. J. (2024) phytools 2.0: an updated R ecosystem for phylogenetic comparative methods (and other things). \emph{PeerJ}, \bold{12}, e16505.
	
	Revell, L. J., D. L. Mahler, P. Peres-Neto, and B. D. Redelings (2012) A new method for identifying exceptional phenotypic diversification. \emph{Evolution}, \bold{66}, 135-146.
}
\author{Liam Revell \email{liam.revell@umb.edu}}
\seealso{
	\code{\link{anc.Bayes}}, \code{\link{brownie.lite}}, \code{\link{evol.vcv}}, \code{\link{minSplit}}, \code{\link{posterior.evolrate}}
}
\keyword{phylogenetics}
\keyword{comparative method}
\keyword{bayesian}
\keyword{continuous character}
