3.3.2.48 Plot

Plot-cmd

Use this command to control window updating of dataset.

Syntax:

plot [option] dataset

To use this command, you must have previously used the layer command to plot dataset into this layer.

Options:

-a wksName nCol valueList; Append a row of numbers starting at nCol

Syntax: plot -a wksName nCol $(c1) $(c2) $(c3) ... or -an wksName nCol c1 c2 c3

Append a row of numbers c1, c2, etc. starting at the given column position nCol (1, 2, 3..) to the specified wksName worksheet.Note that you must enclose numeric variable arguments with $(). This command is especially useful in that the data is added to the graph without causing a complete redraw. Therefore, you can use DDE as a data acquisition tool. This command activates all the real-time related procedures. For realtime numeric plotting, use the -an option.

-an wksName nCol c1 c2 c3 ...

To facilitate making scripts backward compatible, plot -an supports numeric interpretation without using the $() required by

plot -a

-c; Force an update of the active window

Syntax: plot -c

Force an update of the active window (clear screen).

-l; Update the active layer

Syntax: plot -l

Update the active layer.If there is a window update message in the queue for this window, remove it.

-n dataset xvalue yvalue

Syntax: plot -n dataset xvalue yvalue

Append a new point to dataset at the XY position specified.

-nu dataset xvalue yvalue; Undoable append a new point

Syntax: plot -nu dataset xvalue yvalue

Undoable append a new point to dataset at the XY position specified. Press Ctrl+Z or execute menu Edit->Undo to undo the last appended point.

-p; Redraw the page

Syntax: plot -p

Redraw the page without redrawing any objects off the page.

-s; Draw the graph using the full screen

Syntax: plot -s

Draw the graph using the full screen (active graph windows only).This command can only be used with active graph windows. The command draws the page using the full screen.Terminate this mode by double-clicking with your mouse.

-v; Remove any update message

Syntax: plot -v

Remove any update message for the active window.

Examples:

The following script assigns numeric values to two variables and a text value to a string variable, and then appends the variable values and the specified text to columns in the Data1 worksheet.

v1 = 8;
v2 = -13;
%A = sample text;
plot -a book1 1 $(v1) ($(v2)) text (more text) (%A);

The Data1 worksheet appears as follows: