Table of Contents

NAME

data:plot - Plot y vector(s) versus x. (Decida Procedure)

USAGE

          data:plot d args

ARGUMENTS

d data object with columns to be plotted.
args x and y column labels to be plotted, or OPTIONS.

OPTIONS

-frame <frame-name> Name of frame widget to pack plot window in. Can also be ".". If this is not specified, top-level is created.
-title <title> Title of plot.
-xtitle <label> X-axis label.
-ytitle <label> Y-axis label.
-symbol <symbol> Specify symbol for curves.
-symbols <list> List of symbols for symbol menu.
-colors <list> List of colors for color menu.
-wlines <list> List of line widths for plots.
-trace <increasing,decreasing,both> Trace direction. (default is increasing).
-nextdata <data name> Change to new data object, for column names.
-paired Pair x and y labels (x1,y1;x2,y2) instead of x,y1,y2,y3 (default).
-post <file> PostScript plot file is written.
-postfile <file> Specify postscript output file name (without generating file)
-noview Don't display plot.
-show <0,1> Display plot if 1.
-grid <0,1> Display grid if 1.
-big Configure for big fonts (for tiled postcript).
-backcolor <color> set background color of plot
-forecolor <color> set background color of area surrounding plot
-hardcopy Change background colors to white and set relief to flat
-ssize <size> set symbol size
-ssizes <size> List of symbol sizes for plots.
-axes <spec> Axes specifications <LIN_LIN,LIN_LOG,LOG_LOG,LOG_LIN> (first is x, second is y). Also LIN for LIN_LIN, and LOG for LIN_LOG.
-xmin <xmin> specify minimum x-axis value
-ymin <ymin> specify minimum y-axis value
-xmax <xmax> specify maximum x-axis value
-ymax <ymax> specify maximum y-axis value
* Other options are interpreted as file names for comparison.

GLOBALS

env(DISP_MODE) Display mode. One of (XWINDOW|TERMINAL|BATCH). XWINDOW mode makes full use of X11 DISPLAY. TERMINAL mode does nothing. BATCH mode does nothing.
env(DecidaPlotWait) if YES|yes, then wait for single plot to be closed before returning
DecidaPlot Registry of plots, and plot information.
psfont PostScript font mapping array (defined in init.tcl)

RESULTS

X-Y plot megawidget is displayed.

EXAMPLE-CALL

             data d
             d read-inline {{X 1 2 3} {Y 2 4 8}}
             d plot X Y

MOUSE

button 1: zoom-in Pressing down button 1 starts a zoom-in operation. Holding button 1 down and moving to new location displays a zoom-in box with endpoints at original location and current location. Releasing button 1 changes axes limits of graph to those of the zoom-in box.
button 2: restore Pressing down button 2 returns axes limits to the original ones.
button 3: line parameter report Pressing down button 3 starts a line-segment operation for reporting slope and intercepts. Holding down, moving, then releasing define a line-segment. After release, a report of the line-parameters of the defined line segment: slope, y-intercept, x-intercept.
shift-button 3: curve label operation Pressing down button 3 with shift held down starts a curve-label operation. Holding down, moving, then releasing defines a line-segment. After release, prompt for text for the label, and whether or not to add an arrow.
shift-button 1: delete curve label operation Pressing down button 3 with shift held down starts a delete curve-label operation. Holding down, moving, then releasing defines a delete box. After release, any markers within the delete box are removed.

AUTHORS

Richard Booth, Michael McLennan, George Howlett

Table of Contents