Next: addstrings() Up: MacAnova Help File Previous: addmacrofile()   Contents


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

Keywords: plotting
addpoints(x,y) is equivalent to plot(x,y,add:T).  It displays the plot
in LASTPLOT, adding points such as are produced by plot(), and updates
LASTPLOT with the new information.  It is an error if LASTPLOT does not

Arguments x and y are as in plot().  They can be replaced by a structure
with at least two components.  Any components beyond the first two are
ignored.  It is not an error when x or y is NULL; a warning message is
printed and no plotting occurs.

addpoints(Graph,x,y) displays GRAPH variable Graph with the addition of
points such as are produced by plot(), and saves the plot in LASTPLOT.
Graph is not changed (unless it is LASTPLOT).

addpoints(x,y,keep:F) suppresses any change to LASTPLOT.

addpoints(x,y,show:F) suppresses immediate display of the modified graph
but updates LASTPLOT.  This is useful when you are building a complex
graph in stages using addlines(), addchars(), 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_ticks'

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

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

New labels and title may be set only by keywords 'xlab', 'ylab' and

addpoints(x,y,add:F, ...) is equivalent to plot(x,y, ...).

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