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 |

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 information. 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) > 1. 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 'notes'. 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 variables. See also topics chplot(), plot(), showplot(), addchars(), addlines(), addpoints(), tek(), tekx(), vt(), vtx().

Gary Oehlert 2003-01-15