Plot Text

DESCRIPTION:

Places text at the given positions in the current plot.

This function is an S Version 3 generic (see Methods); method functions can be written to handle specific S Version 3 classes of data. Classes which already have methods for this function include:
tree .

USAGE:

text(x, y,  ...) 
text.default(x, y, labels=seq(along=x), cex=par("cex"), col=par("col")) 

REQUIRED ARGUMENTS:

x,y
a S-PLUS object. For text.default, x and y are the coordinates of the points. The coordinates can be given by two arguments that are vectors, or by a single argument x which is a univariate time series, a complex vector, a matrix with 2 columns, or a list containing components named x and y. In the latter case, labels must be given in name=value form.
labels
vector of labels for each point. Normally, labels[i] is plotted at each point (x[i],y[i]); however, if labels is a logical vector of the same length as x and y, the value i is plotted at each (x[i],y[i]) for which labels[i] is TRUE. Missing values (NA) are allowed.

OPTIONAL ARGUMENTS:

cex
character expansion parameter (see par) for each text string. This may be a vector of more than one element.
col
color parameter (see par) for each text string. This may be a vector of more than one element.

Graphical parameters may also be supplied as arguments to this function (see ).

SIDE EFFECTS:

text is added to the current plot. The graphical parameter adj (see par) determines whether the text is right, left or center justified.

DETAILS:

Labels are not plotted at any point with a missing x or y coordinate or a missing label.

If the lengths of x, y, labels, cex, and col are not identical, the shorter vectors are reused cyclically.

The text function can be used after plot(x,y,type="n") which draws axes and the surrounding box without plotting the data.

BUGS:

The strings in the labels argument will be truncated to their first 511 characters.

SEE ALSO:

, , , .

EXAMPLES:

plot(x, y, type="n") 
text(x, y)  #plot i at (x[i], y[i]) 
plot(x1, f1, type="l"); lines(x2, f2) 
text(.3, .7, "function 1"); text(.3, .4, "function 2")