Next: list() Up: MacAnova Help File Previous: lgamma()   Contents


lineplot(x,y [,add:T,linetype:m, impulse:T] [,other graphics keyword
  phrases]), where x is a REAL vector or scalar, y is a REAL vector or
  matrix, and m >= 0 is an integer
lineplot([Graph,] [x,y], keys:str), str a structure whose component
  names are graphics keywords

Keywords: plotting
lineplot(x,y) makes a connected line plot of the data in vector x and
vector or matrix y, drawing lines between the successive points.  When y
has several columns, each column is graphed separately with different
line types, solid, dashed, ..., repeating cyclically when there are
more columns than distinct line types.

Generally, lineplot() should be used only when the values in x are in
increasing or decreasing order, although there are useful exceptions.

It is not an error when x or y is NULL; a warning message is printed and
no plotting occurs.

lineplot(x,y,linetype:k,thickness:w), k > 0 an integer and w > 0 a REAL
scalar draws lines of type k and width w.  The defaults are k = 1 and w
= 1.  k < 0 is the same as abs(k) and k = 0 is the same as k = -1.  The
interpretation of k and w depend on the computer system on which
MacAnova is running.  See topic 'graph_keys'.

lineplot(Str), where Str is a structure with at least two REAL
components, is equivalent to lineplot(Str[1], Str[2]).  For example,
lineplot(x,y) and lineplot(structure(x,y)) are equivalent.  Any
components of Str beyond the first two are ignored.

lineplot() normally creates or replaces GRAPH variable LASTPLOT which
encapsulates everything in the graph.  In addition, if the graph was
drawn in graphics window I, GRAPHWINDOWS[I] is made identical to
LASTPLOT (I is always 1 in non-windowed DOS and Unix/Linux versions).
You can suppress saving the plot information in LASTPLOT and
GRAPHWINDOWS[I] by including 'keep:F' as an argument.  See topics
'graphs' and 'graph_assign' for information on GRAPH variables and
special variable GRAPHWINDOWS.

lineplot(Graph,x,y) or lineplot(Graph,Str), where Graph is a GRAPH
variable, draws the plot encapsulated in Graph, adding to it new

lineplot(x,y,add:T,...) is the same as lineplot(LASTPLOT,x,y,...)
drawing the graph encapsulated in LASTPLOT, adding to it new
information.  An equivalent way to do this is addlines(x,y,...).

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.

lineplot(x,y,impulses:T) draws vertical lines to the points from the
x-axis (y = 0 line), in addition to drawing connecting lines

lineplot(x,y,lines:F [,...]) is equivalent to plot(x,y [,...]).

lineplot(x,y,symbols:c [,...]) is equivalent to chplot(x,y,symbols:c,
lines:T [,...]).  In particular, when c = "###", points are labeled with
the row number when y is a vector and the column number when ncols(y) >

See topic 'graphs' for information on how a scalar or length 2 vector x
specifies equally spaced x-values, on how to save and print plots, and
on writing graphic information to a file.

See topic 'graph_keys' for information on keywords 'title', 'xlab',
'ylab', 'xmin', 'xmax', 'ymin', 'ymax', 'logx', 'logy', 'xaxis',
'yaxis', 'dumb', 'add', 'file', 'linetype', 'thickness', 'silent' and

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

See topic 'graph_assign' for information on how to plot in graphics
window I by GRAPHWINDOWS[I] <- var, where var is a structure or GRAPH

See also topics chplot(), plot(), showplot(), addchars(), addlines(),
addpoints(), tek(), tekx(), vt(), vtx().

Gary Oehlert 2003-01-15