Table of Contents

NAME

DataPlot - Plot y vector(s) versus x. (Decida Itcl Class)

USAGE

             DataPlot dp_handle data_object ?-constructor-options or -config-options?
             dp_handle configure ?-config-option value ..?
             dp_handle cget ?-config-option?
             dp_handle <method>
             delete object dp_handle

CONSTRUCTOR-ARGUMENTS

dp
data_object data object with columns to be plotted.
args x and y column labels to be plotted, or CONSTRUCTOR-OPTIONS, or CONFIG-OPTIONS.

CONSTRUCTION-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.
-paired Pair x and y labels (x1,y1;x2,y2) instead of x,y1,y2,y3 (default).
-nextdata <data name> Change to new data object, for column names.

CONFIG-OPTIONS

-postfile <file> Specify postscript output file name (without generating file)
-wlines <line width list> List of line widths for plots.
-ssizes <symbol size list> List of symbol sizes for plots.
-symbols <symbol list> List of symbols for symbol menu.
-colors <color list> List of colors for color menu.
-title <title> Title of plot.
-xtitle <label> X-axis label.
-ytitle <label> Y-axis label.
-backcolor <color> set background color of plot
-plotbackground <color> set background color of area surrounding plot
-big <1 or 0> Configure for big fonts (for tiled postcript).
-plain <1 or 0> Change background colors to white and set relief to flat
-grid <1 or 0> Display grid if 1.
-legend <1 or 0> Display legend if 1.
-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.
-xaxis <lin/log> specify linear/logarithmic x-axis
-yaxis <lin/log> specify linear/logarithmic y-axis
-xmin <xmin> specify minimum x-axis value
-xmax <xmax> specify maximum x-axis value
-ymin <ymin> specify minimum y-axis value
-ymax <ymax> specify maximum y-axis value

GLOBALS

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}}
             DataPlot dp d 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.

NOTES

proc data:dplot {d args} wraps DataPlot to look like a data method

TO-DO

updating too often
more command-line arguments in data:dplot
save/restore stack improvements: label button with stack position
revamp annotate dialog
line parameters to dialog?
power of ten re-scaling for log axis when one/two limits are -ve

AUTHORS

Richard Booth, Michael McLennan, George Howlett

Table of Contents