
HELP:
     X,Y PLOT accepts data for plotting only from a data file, which could
be either created by the editor or written by a computer program.
     To see what data formats are acceptable by X,Y PLOT, enter "HELP F1/ALL".
To start a new plot, enter "F1=filename" or "READ filename" or "PLOT filename", 
where filename is the name of the data file to be plotted. A default plot 
setup is performed when a valid data file is given.
     To edit plot parameters or setup, enter "AC=parameters" where AC is the
two letter Access Code assigned to the parameters (e.g. GT=graph title).
     To find out what a particular AC stands for, enter "HELP AC" and a brief
explanation will be displayed on the "oops:" line. To find out more on the AC, 
enter "HELP AC/ALL" "HELP AC/MORE" or "HELP AC/FULL".
     Only the setup parameters of one data set is displayed on screen at a time.
To scan the rest of data sets, press PF1 or PF3 or enter "LIST", "NO=N" where 
N is the sequence number of a data set to be displayed.
     To overlay a file, enter "F2=filename" or "OVERLAY filename" or "INCLUDE 
filename". You can overlay as many files as you wish before max number of data 
sets is reached. To delete an existing data set, enter "REMOVE N" or "DELETE N"
where N is the sequence number of the data set.
     To get a description on the dialog commands, enter "HELP COMMANDS".
To start the actual plotting on screen, simply to hit the return key.

COMMAND:
Auxiliary dialogue commands for X,Y PLOT:

EXIT,QUIT       : Exit or quit from the dialogue menu.
HELP  keyword/AC: Invoke the on-line help on a keyword or on an AC.
MISC            : Invoke miscellaneous data manipulation utilities
                  such as data sorting, smoothing, polynomial-fit, ...
REFRESH         : Refresh the dialogue menu if necessary.
PF1,DOWN        : Step active data set pointer down by one.
PF3,UP          : Step active data set pointer   up by one.
LIST            : List all data set parameters.
RESET           : Reset graph to the default setup.
SAVE    filename: Save current plot setup or parameters in a file.
DELETE,REMOVE  N: Delete or remove a data set from the input list
                  where N is data set's sequence number.
PF4,DCL  command: Spawn a system subprocess.
READ    filename: Read a data file to start a new plot, same as F1=filename.
PLOT    filename: Read a data file and plot on screen right away. For a list
                  of qualifiers allowed for READ and PLOT, enter HELP F1/ALL.
SETUP   filename: Use another setup or parameter file, same as F3=filename.
LAYOUT  filename: Use another layout file, same as F4=filename.
OVERLAY,INCLUDE filename: Overlay another data file, same as F2=filename.
WRITE  filename/FORMAT=N: Write all input data sets into a file in data
       format number N. For a list of valid data formats, enter HELP F1/ALL.

MENU:
0: Exit to the main menu.
1: Invoke hardcopy making utility.
   If you just get back from auxiliary layout and would like
   to have the changes just made in the layout to show up on
   the hardcopy, redraw the plot before invoking the hardcopy.
2: Invoke auxiliary layout utility.
3: Invoke the dialogue utility.
4: Zoom the plot (on a Tektronix terminal only).
5: Invoke the GIN utility (on a Tektronix only).
6: Redraw the plot.
$: Spawn a system subprocess.
PF1: Invoke hardcopy making utility without the page setup menu.
PF2: Invoke this help menu.
PF3: Invoke the dialogue utility.
PF4: Spawn a system subprocess.

F1:
Every time you enter a valid data file for F1, you start a new plot.
A default plot setup is performed or initialized and then the default
setup file and the default layout file, if they exist, are used (refer
to parameters F3 and F4 for more information on the default files).
To bypass plot initialization, append "/NOINIT" to the filename.
To bypass reading the default setup file, append "/NOSETUP" to the filename.
To bypass reading the default layout file, append "/NOLAYOUT" to the filename.

Six commonly-used data formats are supported by X,Y PLOT. You can choose
any one of the six data formats when creating your data file and it will
be recognized automatically by X,Y PLOT's data acquisition routine.

(*) Valid Data Format #1 (FORMATTED/ASCII):

        1st line   :  NPTS       !SET ID LABEL
        2nd line on:  X, Y, YB
        ......

     NPTS is the number of data points or x,y pairs in the data set.
     YB is optional error bar value if error bar is to be plotted.
     From NPTS+2th line on, another set of data may follow.
     Example:
                3                            !1000C
                0.70   54.50000
                0.40   26.20000
                0.38   24.39744
                15                           !1500C
                0.32   15.34272   1.45
                0.30   13.20480   1.23
                ......

(*) Valid Data Format #2 (FORMATTED/ASCII):

        1st line on:  X, Y, YB, IT     !SET ID LABEL
        ......

     IT is a non-zero number entered to terminate a set of data
     IT is blank for all data lines except the last one in the set.
     After a non-zero IT, another set of data may follow.  
     IT can be omitted if there is only one set of data in the file.
     YB is the same as for data format #1.
     Example:
                100   10            !Anneal Sample
                300   36
                500   56
                700   90,, 1
                200   3.45          !Quench Sample
                400   5.87
                ......

(*) Valid Data Format #3 (FORMATTED/ASCII):

        1st line   : -NSET
        2nd line on:  X, Y(1), Y(2),..., Y(NSET)
        ......
        !SET ID LABEL FOR THE 1ST SET
        ......
        !SET ID LABEL FOR THE NTH SET

     Here NSET of data share the same X-coordinates
     and must have the same number of data points.
     Example:
                -5
                100  100  120  145  180  250.4
                200  80   97   116  140  265.5
                300  50   75   95   112  304.7
                ......
                !Anneal Sample
                !Quench Sample
                ......

(*) Valid Data Format #4 (FORMATTED/ASCII):

        1st line   :  X1, X2, X3, NPTS        !SET ID LABEL
        2nd line on:  Y(1), Y(2),..., Y(NPTS)
        .....

     NPTS is the number of Y-coordinates per line.
     X1 is the beginning X-coordinate, X2 the ending, X3 the incremental.
     The number of data points for the data set is calculated as follows:
             NUMBER_OF_DATA_POINTS = INTEGER((X2-X1)/X3+0.5)+1
     Example:
               1  100  1  5         !Anneal Sample
               1.05  0.98  2.34  3.45  4.20
               3.45  1.56  0.98  1.23  3.44
               ......
               502  1130  0.5  1    !Quench Sample
               20.5
               45.3
               ......

(*) Valid Data Format #5 (UNFORMATTED/BINARY):

        1st record:  X1, X2, X3        <--- 1st set of data
        2nd record:  (Y(I), I=1, NPTS)
        3rd record:  X1, X2, X3        <--- 2nd set of data
        4th record:  (Y(I), I=1, NPTS)
        ......

     X1,X2,X3 have the same definitions as in data format #4.
     NPTS is the number of data points calculated from X1,X2,X3.

(*) Valid Data Format #6 (UNFORMATTED/BINARY):

        1st record:  NPTS              <--- 1st set of data
        2nd record:  (X(I), I=1, NPTS)
        3rd record:  (Y(I), I=1, NPTS)
        4th record:  NPTS              <--- 2nd set of data
        5th record:  (X(I), I=1, NPTS)
        6th record:  (Y(I), I=1, NPTS)
        ......

     NPTS is th number of data points in the set.

----------------------------------------------------------------------
TIPS for creating a data file:

1) A file can be in any one of the 6 data formats
   but you can not mix data formats in a file.

2) FORMATTED/ASCII files are free of data field formats with a max field
   length of 40 characters. Integers are acceptable data fields and can 
   be mixed with decimals anywhere in the file. Space or spaces as well as
   commas are valid field separators. TAB keys and blank lines are allowed.

3) Optional data set ID labels (max=75 characters) must start with a "!"
   at any column position after the numbers.

4) Following file types are searched for for a file without type
   (in precedence from left to right): *.PLT, *.DAT, *.RAW.

F2:
Every time you enter a valid data file for F2, you accumulate data sets
to be plotted on the current graph. You can enter as many files as you
wish from F2 before you hit the total number of data sets allowed by the
current version of X,Y PLOT. To remove or delete a set of data or sets
of data from input data arrays, use the REMOVE or DELETE command.

F3:
Default setup file or parameter file to save the current plot setup upon 
normal exit from this dialogue menu. Note that a setup file does not store 
the data sets of the graph: graph = data_file + setup_file + layout_file.
You can use a different setup file to plot the current graph by entering 
it in F3 although only the default setup file is used to save the plot
setup. This allows you to plot batches of graphs of similar natures without
redundant specifications of plot setups. "SAVE setup-filename" command allows
you to save the current plot setup into a file in the name and the type of
your own choice. The file type of a setup file is defaulted to *.PAR.

F4:
Auxiliary layout file to overlay and save the layout if you resort to the
auxiliary layout utility of X,Y PLOT to finish the plot. You can use a
different layout file to overlay on the current graph by entering it in
F4. Since only one version of a layout file is maintained by X,Y PLOT,
the file type of a layout file is defaulted to *.DES to prevent you 
from losing a non-layout file by mis-entering it in F4. Note that all 
graphic entries in a layout file are recorded in the units of inches. 
As a result, if you change the plot size of the graph, its layout portion 
if any will not follow. Therefore make up your mind for the plot size before 
you go to the layout.

GT:
Graph title (any alphanumeric information, maximum 75 characters).
By default, graph title is centered between the end points of x-axis at bottom
of the graph. To override the centering, prefix a "!" to the title (note that
you can leave blank spaces between "!" and the title. If any other place for 
graph title is desired, resort to the auxiliary layout utility of X,Y PLOT 
where you can do labeling anywhere and in any direction you want by moving 
a crosshair cursor.

Following control sequences can be embedded in labeling in X,Y PLOT:

     { --- Convert the next non-blank character to superscript.
     } --- Convert the next non-blank character to subscript.

     \sTEXT_STRING^s  --- TEXT_STRING to be italics.
     \bTEXT_STRING^b  --- TEXT_STRING to be boldface.
     \#TEXT_STRING^p  --- TEXT_STRING to be colored in pen code #.

L1/L3:
X-axis label (maximum 75 characters).
By default, the label is centered between the end points of the axis.
To override the centering, prefix a "!" to the label.

Following control sequences can be embedded in labeling in X,Y PLOT:

     { --- Convert the next non-blank character to superscript.
     } --- Convert the next non-blank character to subscript.

     \sTEXT_STRING^s  --- TEXT_STRING to be italics.
     \bTEXT_STRING^b  --- TEXT_STRING to be boldface.
     \#TEXT_STRING^p  --- TEXT_STRING to be colored in pen code #.

L2/L4:
Y-axis label (maximum 75 characters).
By default, the label is centered between the end points of the axis.
To override the centering, prefix a "!" to the label. To draw the label
in horizontal way on top of the y-axis, prefix a "^" to the label. Note
that "!" and "^" are mutually exclusive.

Following control sequences can be embedded in labeling in X,Y PLOT:

     { --- Convert the next non-blank character to superscript.
     } --- Convert the next non-blank character to subscript.

     \sTEXT_STRING^s  --- TEXT_STRING to be italics.
     \bTEXT_STRING^b  --- TEXT_STRING to be boldface.
     \#TEXT_STRING^p  --- TEXT_STRING to be colored in pen code #.

GO:
1st graph band origin(x,y) in inches from the lower-left corner of screen.
The origin also serves as the grant graph origin referred to by all graph
positioning and coordinates. When you move this origin, the whole graph
moves with it. When it comes to making a hardcopy, you can also offset
a graph for this sake without moving it on the screen.

BO:
2nd graph band offsets(x,y) in inches from the 1st graph band origin.
When both x and y offsets are zero, 2nd graph band overlaps with 1st
graph band, x-axis of the 2nd graph band (axis #3) will be positioned 
at top of the graph and its y-axis (axis #4) to the right of the graph,
fencing up the graph window. If any one of offsets or both offsets are 
not zero, split 2 band graph is setup. The offsets will serve as the 
graph origin of the 2nd graph band. The degree of overlapping or 
non-overlapping of the 2 bands depends upon the combinations of the 
values of the 2nd band offsets and the 4 axis lengths of the 2 graph 
bands. Refer to parameter BC of data set drawing parameters for details 
on how to manipulate data sets on both graph bands.

SF:
Overall graph scale factors (x,y) for screen plotting only and they have
the same zoom effect for both graph bands. Overall graph scale factors 
can be adjusted independently when it comes to making the hardcopy.

SE:
Screen erase flag effective only on a Tektronix-4100 terminal.
SE=NO allows for saving the previous plots, building a multi-plot screen,
and producing a hardcopy page from it. The multiple plots could be made
from XYPLOT as well as from other functional routines such as contour
plot, histogram plot, etc.

MQ:
Multi-quadrant plot flag (NO for 1-quadrant; YES for multi-quadrant plot).
You can do a multi-quadrant plot only under the following circumstances:

     (1) It is a one band plot.
     (2) There is at least one axis whose scales span over absolute
         zero coordinate. Consequently one of the axes must be linear
         and visible.

Axis intersection is automatically calculated and performed.

NS:
Error bar length in number of user-entered sigma.
Error bar length is the semi-dimensional length of the error bar.
To skip drawing the error bars for data containing error bars, set NS=0.
Enter "HELP F1/ALL" to see how to enter error bars a data file.

T1/T2/T3/T4:
Axis setup (axis-type, divisions, sub-divisions, scale-digits, axis-pattern).

TY: The valid types of axis are: 1=linear, 2=Log10, 3=Inverse.
    Every time you touch the axis type, an automatic data scaling
    is performed for the axis using full range data points of data
    sets that are set by BC to be plotted on the axis.
    A negative axis type skips drawing the axis (invisible axis).

DV: Number of axis divisions or number of major tickmarks minus one
    on the axis of linear or inverse type. If you choose to specify
    DV, axis scale per division STEP will be calculated from the 
    current values of LOW and HIGH. A negative DV reverses the 
    default side of axis annotation.

dv: Number of minor divisions or tickmarks between major divisions
    or major tickmarks. A negative dv reverses the ticking direction
    of both major and minor tickmarks on the axis.

DG: Total number of digits for the axis scale numbers to be plotted.
    DG=0: scale numbers are optimized within #####.###.
    DG=N: scale numbers are plotted with N digits.
    DG=9: skip drawing all scale numbers on the axis.
    DG<0: skip drawing the scale multiplier (x10**N) if any.

PT: axis pattern code.
    PT=1: draw the axis with both major and minor tickmarks.
    PT=2: draw the axis with major tickmarks only.
    PT=3: draw the axis with grid lines on major tickmarks only.
    PT=4: draw the axis with grid lines on minor tickmarks as well.
    Negative PT: draw the axis with an arrowhead.
    Dual PT(##): fence the opposite side of axis.

Note that TY,DV,dv,DG,PT do not serve as the access-codes for editing
axis drawing parameters; use T1,T2,T3,T4,X1,X2,X3,X4,S1,S2,S3,S4 instead.

X1/X2/X3/X4:
Axis setup (axis-length, 1st-major-tickmark-offset).

LENG: axis length in inches.
TOFF: offset in inches of the 1st and the last major tickmarks
      away from the end points of the axis.
XOFF: axis offset in inches from its default position
      in the direction normal to the axis line.
ROTA: axis rotation angle in degrees from its default position
      (positive angle rotates the axis counter-clockwise)
      and it is independent of each other.

S1/S2/S3/S4:
Axis setup (axis scale units on major tickmarks).

LOW : axis scale value on the 1st major tickmark on the axis.
HIGH: axis scale value on the last major tickmark on the axis.
STEP: axis scale incremental value per major tickmark on linear
      and inverse types of axes, but it's the number of Log10
      cycles on Log10 type of axis.

Four parameters LOW, HIGH, STEP, and DV determine the axis scale.
To do your own axis scale, you only need to specify any 3 of the 4
parameters, the 4th one will be calculated from the specified 3.
However you can only specify LOW and HIGH on a log10 type of axis.

PN:
Pen number or color code from 1 to 7 for drawing the set of data.
A zero pen number skips drawing the set of data.
You can edit data set drawing parameters only in column-run mode using
the following 2 letter access-codes designated for the columns:

           PN, SM, LI, DN, BC, BL, SS, XO, YO, XS, YS, RL
Examples:  PN=2 3 4 2 3 4 2 3 4           SS=0.05,,,,0.06 0.1


where the 1st number after the equal sign is for the 1st set of data,
and the 2nd number for the 2nd set of data etc. You can separate any
2 numbers by a space or spaces or by a comma. To skip changing a number,
you have to use two commas. You can also resort to the following short
hands: 
       PN=2,3,4R   (equivalent to PN=2,3,4,2,3,4,....,2,3,4).
       PN=2,3,4R5  (equivalent to PN=,,,,2,3,4,2,3,4,....,2,3,4).
       SS=0.05I10  (equivalent to SS=,,,,,,,,,0.05)

where letter R signifies repeating the entry unit, I for jumping to,
and the number following letter R or I designates the starting data
set number to change.

SM:
Marker symbol code for drawing each data point in the set of data.

Symbol table: 1=square, 2=solid-square, 3=hexagon, 4=solid-hexagon,
5=triangle, 6=solid-triangle, 7=diamond, 8=solid-diamond, 9=plus, 10=cross,
11=star, 12=double-triangle, 13=circle, 14=circle+cross, 15=full-moon, 
16=right-half-moon, 17=left-half-moon, 18=top-half-moon, 19=bottom-half-moon.

     SM=0: no symbol is to be drawn (line plotting only).
     SM>0: draw symbols together with line segments.
     SM<0: draw symbols only (no line connection between symbols).

If PM=FILL or LOOP, SM designates the pattern of area fill
and a negative SM skips outlining the filled area.

If PM=BAR, SM designates the hatching pattern of bars
and a negative SM skips connecting line segments between bars.

Area-fill/hatching pattern table:

     SM= 1: solid fill (auto-bidirectional. 0.02 inch spacing).
     SM= 2: horizontal bidirectional lines (0.04 inch spacing).
     SM= 3: horizontal bidirectional lines (0.06 inch spacing).
     SM= 4: horizontal bidirectional lines (0.12 inch spacing).
     SM= 5:   vertical bidirectional lines (0.04 inch spacing).
     SM= 6:   vertical bidirectional lines (0.06 inch spacing).
     SM= 7:   vertical bidirectional lines (0.12 inch spacing).
     SM= 8:  45 degree bidirectional lines (0.04 inch spacing).
     SM= 9:  45 degree bidirectional lines (0.06 inch spacing).
     SM=10:  45 degree bidirectional lines (0.12 inch spacing).
     SM=11: -45 degree bidirectional lines (0.04 inch spacing).
     SM=12: -45 degree bidirectional lines (0.06 inch spacing).
     SM=13: -45 degree bidirectional lines (0.12 inch spacing).
     SM=14:  45 degree bidirectional  dots (0.04 inch spacing).
     SM=15:  45 degree bidirectional  dots (0.06 inch spacing).
     SM=16:  45 degree bidirectional  dots (0.12 inch spacing).

A negative SM skips outlining the filled area.

LI:
Line type for drawing the set of data:

     1> solid line.              2> dotted line.
     3> 1-dot center line.       4> short-dash line.
     5> long-dash line.          6> 3-dot-center line.
     7> long-short-dash line.    8> sparse short-dash line.

     LI>0: connect data points with straight line segments.
     LI<0: connect data points with spline-smoothed curve.

DN:
Data point plotting-density/skipping code:

     DN=1: plot every data point in the set of data.
     DN=2: plot every other data point in the set of data.
     .....
     DN=N: plot every Nth data point in the set of data.


BC:
Band assignment Code for the set of data:

     BC=1: the set of data is to be plotted on the 1st graph band.
     BC=2: the set of data is to be plotted on the 2nd graph band.
     BC=3: the set of data is to be plotted on both graph bands.

By default, all data sets are scaled and plotted on the 1st graph band.
You can select some data sets to be scaled and plotted on the 2nd graph
band or on both graph bands but you can not remove all of them from the
1st graph band. You have to have some data sets to be scaled and plotted
on the 1st graph band. Axis #1 and #2 are reserved for the 1st graph band.
Axis #3 and #4 are reserved for the 2nd graph band. Refer parameter BO for
more information on 2 graph band plotting.

BL:
Bold-line or linewidth code in number of the default linewidth.
Bold-line is not implemented on screen plotting but through firmware
or hardcopy of a particular hardcopy making device for hardcopy making
purpose.

SS:
Size of marker symbols in inches if marker symbols are to be plotted.
If PM=BAR, SS designates the bar width for plotting vertical bars.

XO:
Offset in inches from the calculated position along x-axis for drawing
the 1st set of data, but from the previous data set for the rest of the
data sets (offset between data sets in other words). A positive value
of offset shifts the curve to the right and a negative value to the left.

YO:
Offset in inches from the calculated position along y-axis for drawing
the 1st set of data, but from the previous data set for the rest of the
data sets (offset between data sets in other words). A positive value
of offset shifts the curve up and a negative value down.

RL:
Plot reference line in current y-axis scale units for a STICK/BAR/FILL
plot. It is a horizontal reference line that can be set anywhere along
the y-axis within the current graph window.
Refer to parameter PM, SM and SS for details on STICK/BAR/FILL plotting.

PM:
Plotting Mode for drawing the set of data.
Following plotting modes are implemented through their defined keywords:

     DEFAULT: regular line and/or symbol plot.
        FILL: regular line plot plus area fill to horizontal line RL.
        LOOP: regular line plot plus close-loop area fill.
       STICK: regular line and/or symbol plot plus dropping a vertical
              line of type LI to horizontal line RL.
         BAR: regular line plot plus dropping a vertical bar of hatching
              pattern SM and width SS to horizontal line RL.

Refer to parameter SM, SS, RL for more information on non-default plotting.
You can edit parameter PM only for the active set of data that is being 
displayed. To edit the PM for other set of data, use commands F1, F2 and 
NO=N to bring the desired set of data into the display window.

ID:
Data set identification label for the active set of data that is being 
displayed. To edit or enter ID for other set of data, use commands F1, 
F2, and NO=N to bring the desired set of data into the display window.

LB:
Data set ID label drawing flag:

     LB=0: skip drawing all data set ID labels if they are present.
     LB=1: draw all data set ID labels if they are present.
     LB=2: draw all data set ID labels and put a box around them as well.

Refer to parameter LM and LP for related labeling information.

LM:
Data set ID label prefix-marker drawing flag:

     LM=0: skip drawing all prefix-markers.
     LM=1: draw the prefix-markers.

A prefix-marker reflects the line type, symbol, and plotting mode
specified for the set of data being plotted.

LP:
Data set ID label position (x,y) in inches relative to the graph origin.
It refers to the lower-left corner of label box even though the box is
not drawn.
