Next: addhelpfile() Up: MacAnova Help File Previous: acos(x)   Contents


addchars([Graph,] x,y [,symbols:c] [,lines:T,impulse:T]\
  [, graphics keyword phrases])
addchars([Graph] [,x,y [,symbols:c]], keys:str), str a structure whose
  components names match graphics keywords.

Keywords: plotting
addchars(x,y,symbols:c) is equivalent to chplot(x,y,symbols:c,add:T).
It adds character labeled points to the plot in LASTPLOT, displays the
plot, and updates LASTPLOT with the new information.  For compatibility
with past versions, the use of keyword 'symbols' is optional.

Arguments x, y, and c are as for chplot() and the points are labeled the
same way as is done by chplot().  When 'symbols:c' is omitted, the same
default is used as for chplot().  It is not an error when x or y is
NULL; a warning message is printed and no plotting occurs.

It is an error if LASTPLOT does not exist.

Whenever LASTPLOT is updated, the appropriate component of GRAPHWINDOWS
is made identical to LASTPLOT.  See topic 'GRAPHWINDOWS'.

addchars(Graph,x,y,symbols:c) or chplot(Graph,x,y,symbols.c,add:T)
displays GRAPH variable Graph with the addition of character labeled
points, saving the modified plot in LASTPLOT.  Graph is not changed
(unless it is LASTPLOT).

addchars(x,y,symbols:c,keep:F) suppresses any change to LASTPLOT.  The
appropriate element of GRAPHWINDOWS is set to NULL.

addchars(x,y,symbols:c,show:F) suppresses immediate display of the
modified graph or change to GRAPHWINDOWS but updates LASTPLOT.  This is
useful when you are building a complex graph in stages using addchars(),
addlines(), addstrings(), or addpoints().  When you are done, simply
type showplot().  You can't use both show:F and keep:F.

Keywords 'dumb', 'lines', 'linetype', 'thickness', 'impulse', 'xmin',
'xmax', 'ymin', 'ymax', 'logx', 'logy', 'xlab', 'ylab', 'title',
'xaxis', 'yaxis', 'borders', 'ticks', 'xticks', 'yticks', 'xticklen',
'yticklen', 'xticklabs', 'yticklabs', 'height', 'width', 'pause',
'silent' and 'notes' may be used as for other plotting commands.  See
topics 'graph_keys', 'graph_border' and 'graph_keys'

addchars([Graph,] keys:structure(x:x,y:y,symbols:c [other keyword
phrases)) is equivalent to addchars([Graph,] x,y,symbols:c [other
keyword phrases]).  See topic 'graph_keys' for details.

When option 'dumbplot' has been set False (see subtopic
'options:"dumbplot"'), the plot will be a low resolution plot unless
'dumb:F' is an argument.

A value of MISSING for any of xmin, xmax, ymin or ymax (for example,
xmin:?) forces determination of an extreme value from the current data
and data already in the graph.

New labels and title may be set only by keywords 'xlab', 'ylab' and
'title'.  That is addchars(newx:x, newy:y,symbols:c) has no effect on
the axis labels of the graph being modified.

addchars(x,y,symbols:c,add:F, ...) is equivalent to chplot(x,y,
symbols:c, ...) except that LASTPLOT must be defined.

See topic 'graph_assign' for information on another way to add data and
other information to a plot.

See topic 'graphs' for general information on plots and on variable
LASTPLOT.  See topic 'graph_keys' for information on keywords.  See
topic 'graph_files' for information on writing a graph to a file.

Gary Oehlert 2003-01-15