X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=man%2Frtree.Rd;h=48401b5b8341e8a15b439ecbc0a2f599db763319;hb=42bf3d36a0a2a5edd0071739ad346ae9009abffa;hp=63cbf79e5f8a2c1f74602c0845be3140bb2f5fdc;hpb=2e3b8be33765d5311e071efb39871249d16f7e30;p=ape.git diff --git a/man/rtree.Rd b/man/rtree.Rd index 63cbf79..48401b5 100644 --- a/man/rtree.Rd +++ b/man/rtree.Rd @@ -1,10 +1,11 @@ \name{rtree} \alias{rtree} \alias{rcoal} +\alias{rmtree} \title{Generates Random Trees} \usage{ rtree(n, rooted = TRUE, tip.label = NULL, br = runif, ...) -rcoal(n, tip.label = NULL, br = rexp, ...) +rcoal(n, tip.label = NULL, br = "coalescent", ...) rmtree(N, n, rooted = TRUE, tip.label = NULL, br = runif, ...) } \arguments{ @@ -13,9 +14,10 @@ rmtree(N, n, rooted = TRUE, tip.label = NULL, br = runif, ...) (the default).} \item{tip.label}{a character vector giving the tip labels; if not specified, the tips "t1", "t2", ..., are given.} - \item{br}{either an R function used to generate the branch lengths - (\code{rtree}) or the coalescence times (\code{rcoal}), or - \code{NULL} to give no branch lengths in the tree.} + \item{br}{an R function used to generate the branch lengths + (\code{rtree}; use \code{NULL} to simulate only a topology), or the + coalescence times (\code{rcoal}). For the latter, a genuine + coalescent tree is simulated by default.} \item{...}{further argument(s) to be passed to \code{br}.} \item{N}{an integer giving the number of trees to generate.} } @@ -27,14 +29,13 @@ rmtree(N, n, rooted = TRUE, tip.label = NULL, br = runif, ...) } \details{ The trees generated are bifurcating. If \code{rooted = FALSE} in - (\code{rtree}), the tree is trifurcating at its `root'. + (\code{rtree}), the tree is trifurcating at its root. The default function to generate branch lengths in \code{rtree} is - \code{runif}. In \code{rcoal} \code{rexp} is used to generate the - inter-node distances. If further arguments are passed to \code{br}, - they need to be tagged (e.g., \code{min = 0, max = 10}). + \code{runif}. If further arguments are passed to \code{br}, they need + to be tagged (e.g., \code{min = 0, max = 10}). - \code{rmtree} calls successively \code{rmtree} and set the class of + \code{rmtree} calls successively \code{rtree} and set the class of the returned object appropriately. } \value{