https://github.com/cran/ape
Tip revision: 1330e272d62c723b8073c95b066950b294f59697 authored by Emmanuel Paradis on 20 October 2012, 00:00:00 UTC
version 3.0-6
version 3.0-6
Tip revision: 1330e27
write.tree.Rd
\name{write.tree}
\alias{write.tree}
\title{Write Tree File in Parenthetic Format}
\usage{
write.tree(phy, file = "", append = FALSE,
digits = 10, tree.names = FALSE)
}
\arguments{
\item{phy}{an object of class \code{"phylo"} or \code{"multiPhylo"}.}
\item{file}{a file name specified by either a variable of mode character,
or a double-quoted string; if \code{file = ""} (the default) then the
tree is written on the standard output connection (i.e. the console).}
\item{append}{a logical, if \code{TRUE} the tree is appended to the file
without erasing the data possibly existing in the file, otherwise
the file (if it exists) is overwritten (\code{FALSE} the default).}
\item{digits}{a numeric giving the number of digits used for printing
branch lengths.}
\item{tree.names}{either a logical or a vector of mode character. If
\code{TRUE} then any tree names will be written prior to the tree on
each line. If character, specifies the name of \code{"phylo"}
objects which can be written to the file.}
}
\description{
This function writes in a file a tree in parenthetic format using the
Newick (also known as New Hampshire) format.
}
\value{
a vector of mode character if \code{file = ""}, none (invisible
\code{NULL}) otherwise.
}
\details{
The node labels and the root edge length, if available, are written in
the file.
If \code{tree.names == TRUE} then a variant of the Newick format is
written for which the name of a tree precedes the Newick format tree
(parentheses are eventually deleted beforehand). The tree names are
taken from the \code{names} attribute if present (they are ignored if
\code{tree.names} is a character vector).
}
\references{
Felsenstein, J. The Newick tree format.
\url{http://evolution.genetics.washington.edu/phylip/newicktree.html}
Olsen, G. Interpretation of the "Newick's 8:45" tree format standard.
\url{http://evolution.genetics.washington.edu/phylip/newick_doc.html}
}
\author{Emmanuel Paradis, Daniel Lawson
\email{dan.lawson@bristol.ac.uk}, and Klaus Schliep
\email{kschliep@snv.jussieu.fr}}
\seealso{
\code{\link{read.tree}}, \code{\link{read.nexus}},
\code{\link{write.nexus}}
}
\keyword{manip}
\keyword{IO}