File: is.ultrametric.Rd

package info (click to toggle)
r-cran-ape 5.7-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 3,932 kB
  • sloc: ansic: 7,626; cpp: 116; sh: 17; makefile: 2
file content (40 lines) | stat: -rw-r--r-- 1,294 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
\name{is.ultrametric}
\alias{is.ultrametric}
\alias{is.ultrametric.phylo}
\alias{is.ultrametric.multiPhylo}
\title{Test if a Tree is Ultrametric}
\description{
  This function tests whether a tree is ultrametric using the distances
  from each tip to the root.
}
\usage{
is.ultrametric(phy, ...)
\method{is.ultrametric}{phylo}(phy, tol = .Machine$double.eps^0.5, option = 1, ...)
\method{is.ultrametric}{multiPhylo}(phy, tol = .Machine$double.eps^0.5, option = 1, ...)
}
\arguments{
  \item{phy}{an object of class \code{"phylo"} or \code{"multiPhylo"}.}
  \item{tol}{a numeric >= 0, variation below this value are considered
    non-significant.}
  \item{option}{an integer (1 or 2; see details).}
  \item{\dots}{arguments passed among methods.}
}
\details{
  The test is based on the distances from each tip to the root and a
  criterion: if \code{option = 1}, the criterion is the scaled range
  ((max - min/max)), if \code{option = 2}, the variance is used (this
  was the method used until ape 3.5). The default criterion is invariant
  to linear changes of the branch lengths.
}
\value{
  a logical vector.
}
\author{Emmanuel Paradis}
\seealso{
  \code{\link{is.binary}}, \code{\link[base]{.Machine}}
}
\examples{
is.ultrametric(rtree(10))
is.ultrametric(rcoal(10))
}
\keyword{utilities}