https://github.com/cran/ape
Tip revision: 06eed037570caee527af9ede1e3f77a2b9b5f3bc authored by Emmanuel Paradis on 03 June 2003, 00:00:00 UTC
version 1.1
version 1.1
Tip revision: 06eed03
skylineplot.Rd
\name{skylineplot}
\alias{skylineplot}
\alias{plot.skyline}
\alias{lines.skyline}
\alias{skylineplot.deluxe}
\title{Drawing Skyline Plot Graphs}
\usage{
\method{plot}{skyline}(x, reverse.time = FALSE, \dots)
\method{lines}{skyline}(x, reverse.time = FALSE, \dots)
skylineplot(z, \dots)
skylineplot.deluxe(tree, \dots)
}
\arguments{
\item{x}{skyline plot data (i.e. an object of class \code{"skyline"}).}
\item{z}{Either an ultrametric tree (i.e. an object of class \code{"phylo"}),
or coalescent intervals (i.e. an object of class \code{"coalescentIntervals"}), or
collapsed coalescent intervals (i.e. an object of class \code{"collapsedIntervals"}).}
\item{tree}{ultrametric tree (i.e. an object of class \code{"phylo"}).}
\item{\dots}{further arguments to be passed to \code{skyline()} and \code{plot()}.}
\item{reverse.time}{Option that determines whether the time axis in the
skyline plot runs from the past to the present (the default) or from
the present to the past.}
}
\description{
These functions provide various ways to draw \emph{skyline plot} graphs
on the current graphical device. Note that \code{skylineplot(z, \dots)} is simply
a shortcut for \code{plot(skyline(z, \dots))}.
The skyline plot itself is an estimate of effective population size through time,
and is computed using the function \code{\link{skyline}}.
}
\details{
See \code{\link{skyline}} for more details (incl. references) about the skyline plot method.
}
\author{Korbinian Strimmer (\url{http://www.stat.uni-muenchen.de/~strimmer/})}
\seealso{
\code{\link[base]{plot}} and \code{\link[base]{lines}} for the basic plotting
function in R, \code{\link{coalescent.intervals}}, \code{\link{skyline}}}.
}
\examples{
library(ape)
# get tree
data("hivtree.newick") # example tree in NH format
tree.hiv <- read.tree(text = hivtree.newick) # load tree
#### classic skyline plot
skylineplot(tree.hiv) # shortcut
#### plot classic and generalized skyline plots and estimate epsilon
sk.opt <- skylineplot.deluxe(tree.hiv)
sk.opt$epsilon
#### classic and generalized skyline plot ####
sk1 <- skyline(tree.hiv)
sk2 <- skyline(tree.hiv, 0.0119)
plot(sk1, col=c(grey(.8),1), reverse.time=TRUE)
lines(sk2, reverse.time=TRUE)
legend(.15,500, c("classic", "generalized"), col=c(grey(.8),1),lty=1)
#### various skyline plots for different epsilons
layout(mat= matrix(1:6,2,3,byrow=TRUE))
ci <- coalescent.intervals(tree.hiv)
plot(skyline(ci, 0.0));title(main="0.0")
plot(skyline(ci, 0.007));title(main="0.007")
plot(skyline(ci, 0.0119),col=4);title(main="0.0119")
plot(skyline(ci, 0.02));title(main="0.02")
plot(skyline(ci, 0.05));title(main="0.05")
plot(skyline(ci, 0.1));title(main="0.1")
layout(mat= matrix(1:1,1,1,byrow=TRUE))
}
\keyword{hplot}