\title{Write Tree File in Parenthetic Format}
\usage{
write.tree(phy, file = "", append = FALSE,
- digits = 10)
+ digits = 10, tree.names = FALSE)
}
\arguments{
- \item{phy}{an object of class \code{"phylo"}.}
+ \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).}
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
}
\value{
a vector of mode character if \code{file = ""}, none (invisible
- `NULL') otherwise.
+ \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/newick_doc.html}
}
-\author{Emmanuel Paradis \email{Emmanuel.Paradis@mpl.ird.fr}}
+\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}
+\keyword{IO}
\ No newline at end of file