Place Text on a Dendrogram

DESCRIPTION:

Labels the current plot of the tree dendrogram with text.

USAGE:

text.arbor(x, splits=T, label="yval", FUN=text, all=F, pretty=NULL,
digits=.Options$digits - 3, use.n=F, fancy=F, fwidth=0.8, fheight=0.8, ...)

REQUIRED ARGUMENTS:

x
fitted model object of class arbor. This is assumed to be the result of some function that produces an object with the same named components as that returned by the arbor function.

OPTIONAL ARGUMENTS:

splits
logical flag. If TRUE (default), then the splits in the tree are labeled with the criterion for the split.
label
a column name of x$frame; values of this will label the nodes. For the class method, label='yval' results in the factor levels being used, 'yprob' results in the probability of the winning factor level being used, and 'specific yval level' results in the probability of that factor level.
FUN
the name of a labeling function, e.g. text.
all
Logical. If TRUE, all nodes are labeled, otherwise just terminal nodes.
pretty
an integer denoting the extent to which factor levels in split labels will be abbreviated. A value of (0) signifies no abbreviation. A NULL, the default, signifies using elements of letters to represent the different factor levels.
digits
number of significant digits to include in numerical labels.
use.n
Logical. If TRUE (default), adds to label (#events level1/ #events level2/etc. for class, n for anova, and # events/n for poisson and exp).
fancy
Logical. If TRUE, nodes are represented by ellipses (interior nodes) and rectangles (leaves) and labeled by yval. The edges connecting the nodes are labeled by left and right splits.
fwidth
Relates to option fancy and the width of the ellipses and rectangles. If `fwidth < 1' then it is a scaling factor (default = .8). If `fwidth > 1' then it represents the number of character widths (for current graphical device) to use.
fheight
Relates to option fancy and the height of the ellipses and rectangles. If `fheight <1' then it is a scaling factor (default = .8). If `fheight > 1' then it represents the number of character heights (for current graphical device) to use.
...
Graphical parameters may also be supplied as arguments to this function (see par).

SIDE EFFECTS:

the current plot of a tree dendrogram is labeled.

SEE ALSO:

, , , , ,

EXAMPLES:

freen.tr <- arbor(freeny.y ~ freeny.x)
plot(freen.tr)
text(freen.tr, use.n=T, all=T)