man/summary.phylo.Rd

   1 \name{summary.phylo}
   2 \alias{summary.phylo}
   3 \alias{Ntip}
   4 \alias{Nnode}
   5 \alias{Nedge}
   6 \title{Print Summary of a Phylogeny}
   7 \usage{
   8 \method{summary}{phylo}(object, \dots)
   9 Ntip(phy)
  10 Nnode(phy, internal.only = TRUE)
  11 Nedge(phy)
  12 }
  13 \arguments{
  14   \item{object, phy}{an object of class \code{"phylo"}.}
  15   \item{\dots}{further arguments passed to or from other methods.}
  16   \item{internal.only}{a logical indicating whether to return the number
  17     of internal nodes only (the default), or of internal and terminal
  18     (tips) nodes (if \code{FALSE}).}
  19 }
  20 \description{
  21   The first function prints a compact summary of a phylogenetic tree (an
  22   object of class \code{"phylo"}). The three other functions return the
  23   number of tips, nodes, or edges, respectively.
  24 }
  25 \details{
  26   The summary includes the numbers of tips and of nodes, summary
  27   statistics of the branch lengths (if they are available) with mean,
  28   variance, minimum, first quartile, median, third quartile, and
  29   maximum, listing of the first ten tip labels, and (if available) of
  30   the first ten node labels. It is also printed whether some of these
  31   optional elements (branch lengths, node labels, and root edge) are not
  32   found in the tree.
  33
  34   \code{summary} simply prints its results on the standard output and is
  35   not meant for programming.
  36 }
  37 \value{
  38   A NULL value in the case of \code{summary}, a single numeric value for
  39   the three other functions.
  40 }
  41 \author{Emmanuel Paradis \email{Emmanuel.Paradis@mpl.ird.fr}}
  42 \seealso{
  43   \code{\link{read.tree}}, \code{\link[base]{summary}} for the generic R
  44   function
  45 }
  46 \examples{
  47 data(bird.families)
  48 summary(bird.families)
  49 Ntip(bird.families)
  50 Nnode(bird.families)
  51 Nedge(bird.families)
  52 }
  53 \keyword{manip}