\HeaderA{text.rpart}{Place Text on a Dendrogram}{text.rpart}
\keyword{tree}{text.rpart}
\begin{Description}\relax
Labels the current plot of the tree dendrogram with text.
\end{Description}
\begin{Usage}
\begin{verbatim}
## S3 method for class 'rpart':
text(x, splits=TRUE, label="yval", FUN=text, all=FALSE,
     pretty=NULL, digits=getOption("digits") - 3, use.n=FALSE,
     fancy=FALSE, fwidth=0.8, fheight=0.8, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x}] fitted model object of class \code{rpart}.  This is assumed to be the result
of some function that produces an object with the same named
components as that returned by the \code{rpart} function.

\item[\code{splits}] logical flag.  If \code{TRUE} (default), then the splits in the tree are
labeled with the criterion for the split.

\item[\code{label}] a column name of \code{x\$frame};  values of this
will label the nodes.  For the \code{"class"} method,
\code{label="yval"} results in the factor levels
being used, \code{"yprob"} results in the probability of the winning factor
level being used, and \sQuote{specific yval level} results in the probability
of that factor level.   

\item[\code{FUN}] the name of a labeling function, e.g. \code{text}.  

\item[\code{all}] Logical.  If \code{TRUE}, all nodes are labeled, otherwise just
terminal nodes.

\item[\code{pretty}] an integer denoting the extent to which factor levels in split labels
will be abbreviated.  A value of (0) signifies no abbreviation.  A
\code{NULL}, the default, signifies using elements of letters to represent
the different factor levels.

\item[\code{digits}] number of significant digits to include in numerical labels.

\item[\code{use.n}] Logical.  If \code{TRUE}, adds to label 
(\#events level1/ \#events level2/etc. for \code{class},
\code{n} for \code{anova}, and \#events/n for \code{poisson} and \code{exp}).

\item[\code{fancy}] Logical.  If \code{TRUE}, nodes are represented by ellipses (interior nodes)
and rectangles (leaves) and labeled by \code{yval}.  The edges connecting the
nodes are labeled by left and right splits.

\item[\code{fwidth}] Relates to option \code{fancy} and the width of the ellipses and rectangles.
If \code{fwidth < 1} then it is a scaling factor (default = 0.8).  If 
\code{fwidth > 1} then it representes the number of character widths 
(for current graphical device) to use.

\item[\code{fheight}] Relates to option \code{fancy} and the height of the ellipses and rectangles.
If \code{fheight <1} then it is a scaling factor (default = 0.8).  If
\code{fheight > 1} then it represents the number of character heights 
(for current graphical device) to use.

\item[\code{...}] Graphical parameters may also be supplied as arguments to this
function (see \code{par}).  As labels often extend outside the plot
region it can be helpful to specify \code{xpd = TRUE}.

\end{ldescription}
\end{Arguments}
\begin{Section}{Side Effects}
the current plot of a tree dendrogram is labeled.
\end{Section}
\begin{SeeAlso}\relax
\code{\LinkA{text}{text}}, \code{\LinkA{plot.rpart}{plot.rpart}}, \code{\LinkA{rpart}{rpart}},
\code{\LinkA{post.rpart}{post.rpart}}, \code{\LinkA{abbreviate}{abbreviate}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
freen.tr <- rpart(y ~ ., freeny)
plot(freen.tr)
text(freen.tr, use.n=TRUE, all=TRUE)
\end{ExampleCode}
\end{Examples}

