
HELP:
(*) CONTOUR or MAP PLOT accepts data for plotting only from a data file,
    which could be either program written or created by the editor.
(*) To see what data formats are acceptable by MAP 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
    and is called the 1st map file.
    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 "help:" line. To find out more on the
    AC, enter "HELP AC/ALL" or "HELP AC/MORE" or "HELP AC/FULL".
(*) To overlay a map file, enter "F2=filename" or "OVERLAY filename" where
    filename is the name of the data file to be plotted and is called the
    2nd map file which must have the same grid size as in the 1st map file.
(*) To get a description of the dialogue commands, enter "HELP COMMANDS".
(*) To start the actual plotting on screen, simply to hit the return key.

COMMAND:
Auxiliary dialogue commands for CONTOUR PLOT:

EXIT, QUIT      : Exit or quit from the dialogue menu.
PF2, HELP AC/keyword: Invoke the on-line help on a keyword or an AC.
PF1, REFRESH    : Refresh the dialogue menu.
PF3, RESET      : Reset graph to the default setup.
SAVE    filename: Save current plot setup or parameters in a file.
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 or PLOT, enter HELP F1/ALL.
OVERLAY,INCLUDE filename: Overlay another data file, same as F2=filename.
SETUP   filename: Use another setup or parameter file, same as F3=filename.
LAYOUT  filename: Use another layout file, same as F4=filename.
PF4, DCL command: Spawn a system subprocess.

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.

Acceptable data format #1 for a map file (FORMATTED/ASCII):

      1st line: X1, X2, NC, Y1, Y2, NR
      2nd line: Z(1,1), Z(2,1), ...., Z(NC,1)
      3rd line: Z(1,2), Z(2,2), ...., Z(NC,2)
      ........  .......
     NRth line: Z(1,NR), Z(2,NR), ...., Z(NC,NR)

Acceptable data format #2 for a map file (UNFORMATTED/BINARY):

      1st record: X1, X2, NC, Y1, Y2, NR
      2nd record: ((Z(I,J), I=1,NC), J=1,NR)

where X1 and X2 are beginning and ending X-coordinates, and NC is number 
of grid points or equally-spaced columns in the map; Y1 and Y2 beginning
and ending Y-coordinates, and NR number of grid points or equally-spaced 
rows in the map; Z(I,J) the contour level at map point (X(I),Y(J)).

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

F2:
To overlay the 2nd map, it must have the same grid size (same numbers of
columns and rows). X,Y boundaries of the 2nd map takes those of the 1st
map. The 1st map drawing parameters apply to the contouring of the 1st 
map and the 2nd applies to the contouring of the 2nd.

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 MAP 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 MAP 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 MAP 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 MAP 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:
X-axis label of the graph (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 MAP 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:
Y-axis label of the graph (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 MAP 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:
Graph origin(x,y) in inches from the lower-left corner of screen and is
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.

SF:
Overall graph scale factors (x,y) for screen plotting and they 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 MAPLOT as well as from other functional routines such as XYPLOT,
histogram plot, etc.

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

DV: Number of axis divisions or number of major tickmarks minus one
    on the axis. 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,X1,X2,S1,S2 instead.

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

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:
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 the 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.
Note: LOW and HIGH are rounded off to the x or y coordinates of
the nearest grid points if they are not right on any grid points.

LM:
Contour minimum point if required is marked with a hollow triangle
together with its minimum value using the color designated for the
lowest contour level on the map. Contour maximum point if required 
is marked with a solid triangle together with its maximum value using
the color designated for the highest contour level on the map. If map
expansion is performed (see parameter GF or GS), the minimum or the 
maximum value may differ from that calculated in the original maps
and in this case it may not be right on a grid point.

LB:
Contour level label drawing flag:

     LB=0: skip drawing the contour level labels.
     LB=1: draw the contour level labels.
     LB=2: draw the contour level labels and put a box around them as well.

Use parameter LP to position the label box even though it is not drawn.

LF/LS:
Following types of lines are available for drawing a contour level:

     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.

BF/BS:
Bold-line or linewidth code is specified in number of default linewidth
and they are hardcopy-device dependent and implemented only on a hardcopy.

FF/FS:
Area-fill pattern table:

      0> area-fill off, line plot assumed.
      1> solid fill (auto-bidirectional. 0.02 inch spacing).
      2> horizontal bidirectional lines (0.04 inch spacing).
      3> horizontal bidirectional lines (0.06 inch spacing).
      4> horizontal bidirectional lines (0.12 inch spacing).
      5>   vertical bidirectional lines (0.04 inch spacing).
      6>   vertical bidirectional lines (0.06 inch spacing).
      7>   vertical bidirectional lines (0.12 inch spacing).
      8>  45 degree bidirectional lines (0.04 inch spacing).
      9>  45 degree bidirectional lines (0.06 inch spacing).
     10>  45 degree bidirectional lines (0.12 inch spacing).
     11> -45 degree bidirectional lines (0.04 inch spacing).
     12> -45 degree bidirectional lines (0.06 inch spacing).
     13> -45 degree bidirectional lines (0.12 inch spacing).
     14>  45 degree bidirectional  dots (0.04 inch spacing).
     15>  45 degree bidirectional  dots (0.06 inch spacing).
     16>  45 degree bidirectional  dots (0.12 inch spacing).

If the designated contour level for area-fill is not a close loop,
area-fill is performed to the nearest x and/or y axis boundaries.
A negative pattern number skips outlining the filled area.

GF/GS:
Map grid expansion or smoothing is implemented through a spline function
interpolation algorithm. A grid expansion factor 1, for example, will 
double the total number of columns and rows of the map, which by no mean
can exceed the max grid size of the program.
