1 GRAFIT
  Invokes R.S. Zhou's interactive 2-d graphics utility --- a friendly,
  straightforward and sophisticated plotting routine, written in Vax-
  FORTRAN and designed particularly for engineering scientists to run 
  a Vax/VMS computer, performing the following graphics functions:

     [1] XY_PLOT                [5] PIECHART_PLOT
     [2] LAYOUT PLOT            [6] TEXT_PLOT
     [3] CONTOUR_PLOT           [7] FUNCTION_PLOT
     [4] HISTOGRAM_PLOT         [8] DIGITIZATION

  Before activating GRAFIT, you should set up the terminal using
  the following command line:

  $ SET TERMINAL/NOWRAP/DEVICE=VT100/INSERT/NOESCAPE

  Format: GRAFIT [filename,...]
2 Parameter       
  There are two ways you can invoke GRAFIT:

     [1] In interactive screen plotting mode.
     [2] In non-interactive hardcopy making mode.

  depending on the specification of command qualifier(s). Parameter P1
  is optional for way [1] and mandatory for way [2] to pass name(s) of 
  data file(s) to be plotted. If you choose to pass more than one file
  names, separate them with commas.
2 Dialog_features
  Menu and form driven, risk-free and die-hard, and random-access
  oriented dialogue scheme, combined with DCL-like command inputs,
  allows for direct access of any single graph parameter and a group 
  of graph parameters, and fast data input and output.

  User-menu-free oriented on-line help utility, of both concise and 
  comprehensive forms, are available anywhere along dialogue session.

  Default plot setups are provided throughout the program. Simply giving 
  the name of a valid data file is sufficient to initiate screen plotting.
  Further manipulation of plot setup or decoration of the graph is
  automatically recorded and saved so that the same plot can be started
  from where it was last left off. Consequently it is particularly 
  run-time efficient, especially when it comes to deal with large 
  volume of data or batches of data.

  What-you-see-on-screen-is-what-you-get oriented hardcopy making 
  utility can be invoked with a single command or keystroke, and the 
  intermediate plot files and DCL command procedures involved are 
  transparent to general users.

  Program-level handling of CTRL/C and CTRL/Y interrupts are provided
  to accomplish screen-clean-up on CTRL/Y and plot-canceling on CTRL/C.
2 XY_plot        
  Grafit's XY_plot is much more than a line-chart routine.
  An outline of features offered by XY_plot is given below:

  Accept data input only from an existing data file, which could be
  either editor-written or program-written; allow for multiple data 
  set and multiple data file input (overlay); recognize multiple data
  file formats including some binary formats. ASCII files are free of
  data field format. Refer to subtopic File_formats for detailed 
  information on acceptable data file formats for XY_plot.

  Does automatic data scaling as well as user-specified data scaling
  for linear, inverse linear, and log10 types of axis, while allowing 
  for user-control over such axis drawing parameters as axis division,
  tickmark offset and direction, significant digits, etc...

  Multiple x-axis and y-axis of same or different types and scalings,
  split axis on a single plot, and multi-plots per page, etc... are
  easily executable.

  Error bar plot, multi-quadrant plot, non-orthogonal axis plot,
  area-fill plot, stick plot, bar plot are also implemented in 
  addition to the usual line plus symbol plot.

  Spline-smooth, least-square polynomial fit, data sorting, data 
  column swap, multiple data set averaging and subtraction, data 
  filtering and differentiation are readily applicable.

  Data point sampling, curve rescaling and offsets along both x 
  and y axis are allowed.

  Utilization of a data independent plot setup file, which allows 
  not only for later duplication of the same plot but also for 
  plotting of batches of data with similar nature without redundant 
  manipulation of plot setup.

  Auxiliary layout utility allows for plot labeling or annotation 
  anywhere and in any arbitrary orientation on the graph as well
  as for overlaying of a variety of 2-d geometric patterns such
  as line segment, curve, arrowhead, box, circle, polygon, etc..
  In other words, you can basically design and paint your graph
  in your own way.
2 Layout_plot   
  GRAFIT's layout routine is basically a 2-D CAD. It allows for drawing
  of precision layouts of publication quality such as flow-charts and 
  schematic diagrams without professional knowledge and training in CAD.
  It offers three main utilities by exploiting the segment graphics, GIN, 
  and macro capability of a Tektronix-4100 graphics terminal:

     [1] Command format oriented layout in COMMAND mode.
     [2] Graphics INput (GIN) oriented layout in GIN mode.
     [3] Entry format oriented layout in ENTRY mode.

  In layout COMMAND mode, you can manipulate layout files using layout
  commands like PLOT, OVERLAY, etc; set layout attributes such as layout 
  scale, using layout command SET; enable ENTRY mode or GIN mode using 
  layout command ENTRY or GIN to perform interactive layout other than 
  from a layout file; transform existing layout using layout commands 
  like MOVE, ROTATE, ZOOM, COLOR, FILL, COPY, etc. in conjunction with 
  definable function keys and keypad.

  In layout GIN mode, you can manipulate the existing layout entries,
  draw lines and curves, do text annotation etc., using GIN crosshair 
  cursor in conjunction with defined function keys and keypad. 

  In layout ENTRY mode, you can draw new layout entries by specifying 
  precise and detailed entry parameters from keyboard input. Following 
  basic types of layout entries or 2-D geometric patterns are pre-defined:
  arc, circle, ellipse, pie, bar, box, oblique, polygon, and a variety of 
  arrowheads and symbols. Line, curve and text layout are implemented only 
  in GIN mode. User-menu-free oriented on-line help utility, of both 
  concise and comprehensive forms, are available in the layout.
2 Function_plot  
  GRAFIT'S function plot is actually a mathematical function digitization 
  routine. It allows for generation of a single variable curve or two 
  variable density plane from an arbitrary mathematical function in the 
  form of z=f(x,y), where z represents a digitized array or grid of 
  function values to be computed in a user specified x,y space. 
  The results are written to a data file ready to be plotted by the x,y 
  plot or contour plot routine depending upon the number of variables 
  used in the math function. The function to be computed is typed in 
  interactively from the keyboard in the formula of FORTRAN-77 conventions;
  a scratch FORTRAN file is then written by the program which in turn gets 
  compiled, linked, and executed to produce the results. 

  To enhance efficiency of input and flexibility of computation, a number
  of user-specifiable constants and built-in mathematical and physical 
  constants (e.g. pi, Avogadro constant N, Planck constant h, speed of 
  light etc.) can also be embedded in the formula of input function.
2 Combine_plot  
  Combine_plot means putting on a single page multiple plots of the same
  or different natures (such as multi XY plots or an XY plot on a contour
  map), in addition to those multi-plots-per-screen features allowed by
  XYPLOT and layout overlay. There are two ways you can accomplish a 
  combination plot:

     [1] build the page on screen.
     [2] build the page on hardcopy only.

  Way [1] can only be performed on a TEK-4100 graphics terminal
  supporting segment graphics or screen saving. The plots are
  collected on screen by disabling the screen-erase flag "SE"
  built in individual functional routines and what you see on 
  screen is what you will get on the hardcopy. Maximum 10 plots
  can be put on a single output page.

  Way [2] can be performed on any kind of terminal. It is done
  by disabling the page feed flag "PF" and by manipulating the
  plot offsets "PO" on the menu of hardcopy setup page for all
  plots except for the last one. There is no limit to how many
  plots can be put on a single output page.
2 Linetype_table
  Following types of drawing line are implemented in GRAFIT:

     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.
2 Symbol_table  
  Following graphics marker symbols are implemented in GRAFIT:

     1> square                   11> star
     2> solid-square             12> double-triangle
     3> hexagon                  13> circle
     4> solid-hexagon            14> circle+cross
     5> triangle                 15> full-moon
     6> solid-triangle           16> right-half-moon
     7> diamond                  17> left-half-moon
     8> solid-diamond            18> top-half-moon
     9> plus                     19> bottom-half-moon
    10> cross
2 Fill_pattern_table
  Following area_fill/shading patterns are implemented in GRAFIT:

     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).
2 File_formats
  XYplot, histogram plot, contour plot, and text plot accept data 
  for plotting only from an existing file, which could be either
  editor-written or program-written. Following subtopics contain
  specific file format protocol that should be observed by a user.
3 XYPLOT
  Six commonly-used data file 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. Tips for creating a valid input data file:

  [1] 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 digits. 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 label (max=75 characters) must start with 
      a "!" at any column position after the numbers.

  [4] Following file types are searched for a file without type
      (in precedence from left to right): PLT, DAT, RAW.
4 1st_format(ASCII)
  Valid data file 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
     ......
4 2nd_format(ASCII)
  Valid data file 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
     ......
4 3rd_format(ASCII)
  Valid data file format #4 (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

  where 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
     !......
4 4th_format(ASCII)
  Valid data format #4 (FORMATTED/ASCII):

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

  where 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 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
     ......
4 5th_format(binary)
  Valid data file 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)
     ......

  where X1,X2,X3 have the same definitions as in data format #4.
  NPTS is the number of data points calculated from X1,X2,X3.
4 6th_format(binary)
  Valid data file 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)
     ......

  where NPTS is th number of data points in the set.
4 Setup_file_format
  By default XY_plot searches, after reading an input data file, 
  for a setup file of the same name as the data file and but of
  type PAR to setup an xyplot, and updates the setup file every
  time you exit from the dialogue menu. A setup file contains 
  only setup parameters but not the data, which makes it possible
  to use a common setup file to plot the same or modified data file
  or another data file of similar nature so that duplicated or
  redundant plot setup is avoided. If the search fails, default 
  plot setup with automatic data scaling is performed. This section 
  describes the format of the setup file used by XY_plot and it's 
  intended for those who wish to prepare a setup file for their own
  xyplots.

  The setup file is keyword oriented ASCII file with each keyword 
  identifying a setup parameter or a group of setup parameters and
  occupying a single record line in the file. The line format is a
  4-letter keyword followed by an equal sign followed by its setup 
  parameter(s) and is free of data field formats. You only need to 
  write the keyword lines that are necessary, and for those missing
  XY_plot uses the default setup values.  Following is list of 
  defined keywords together with their setup parameters:

  TITL=graph title (alphanumeric information. max 75 chars)
  XLB1=1st x-axis label (alphanumeric information. max 75 chars)
  YLB1=1st y-axis label (alphanumeric information. max 75 chars)
  XLB2=2nd x-axis label (alphanumeric information. max 75 chars)
  YLB2=2nd y-axis label (alphanumeric information. max 75 chars)

  OVER= LB, LM, MQ, NS, C1, C2, XL, YL, XO, YO, XS, YS, XF, YF


     	LB: flag for drawing data set id labels.
     	    0 = skip drawing all data id set labels if any.
     	    1 = draw the data set id labels if any.
     	    2 = draw and box the data set id labels if any.
     	LM: flag for drawing data set id label leading markers
     	    which identify color, linetype, symbol, filling
     	    status of the data sets.
     	    0 = skip drawing the leading markers.
     	    1 = draw the leading markers.
     	MQ: flag for a multi-quadrant plot.
     	    0 = designate a single quadrant plot.
     	    1 = designate a  multi quadrant plot.
     	NS: length of error bars if any in number of input sigma.
     	C1: axis color number or pen code for the 1st graph band.
     	C2: axis color number or pen code for the 2nd graph band.
     	XL: x-coordinate in inches of the lower-left corner of
     	    data set id label box.
     	YL: y-coordinate in inches of the lower-left corner of
     	    data set id label box.
     	XO: x-coordinate in inches of the graph origin.
     	YO: y-coordinate in inches of the graph origin.
     	XS: x-coordinate in inches of the 2nd graph band offset.
     	YS: y-coordinate in inches of the 2nd graph band offset.
     	XF: overall scale factor of graph in x-dimension.
     	YF: overall scale factor of graph in y-dimension.

  XAX1= AT, DV, dv, ND, PT, LN, TO, AO, RA, LO, HI, IN
     	Axis drawing parameters for the 1st x-axis.

  YAX1= AT, DV, dv, ND, PT, LN, TO, AO, RA, LO, HI, IN
     	Axis drawing parameters for the 1st y-axis.
  XAX2= AT, DV, dv, ND, PT, LN, TO, AO, RA, LO, HI, IN

     	Axis drawing parameters for the 2nd x-axis.
  YAX2= AT, DV, dv, ND, PT, LN, TO, AO, RA, LO, HI, IN
     	Axis drawing parameters for the 2nd y-axis.


     	AT: axis type (1=linear, 2=log10, 3=inverse-linear).
     	    A negative type number skips drawing the axis.
     	DV: axis major number of divisions with scale numbers.
     	    A number of zero designates automatic divisions.
     	    A negative number reverses the default side of
     	    axis annotation.
     	dv: axis minor number of divisions between the majors.
     	    A negative number reverse the default side of
     	    tickmark direction.
     	ND: number of significant digits for axis scale numbers.
     	    0=scale numbers are optimized within #####.###.
     	    N=scale numbers are plotted with N digits.
     	   -N=skip drawing the scale multiplier (x10**?) if any.
     	    9=skip drawing all scale numbers on the axis.

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

     	LN: axis length in inches.
        TO: offset in inches of the 1st and the last major tickmarks
     	    away from the end points of the axis.
     	AO: axis offset in inches from its default position
     	    in the direction normal to the axis line.
     	RA: axis rotation angle in degrees from its default position
     	    (positive angle rotates the axis counter-clockwise)
     	    and it is independent of the other axis.
     	LO: axis scale value on the 1st major tickmark on the axis.
     	HI: axis scale value on the last major tickmark on the axis.
     	IN: 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.

  SETS= PN, SM, LI, DN, BC, BL, PM, SS, XO, YO, XF, YF, RL


     	Data set drawing parameters for each set of data.

     	PN: pen number from 1 through 7 (0=skip drawing this set).
     	SM: symbol number from 1 through 19. Refer to the subtopic
     	    SYMBOL_TABLE for symbol type description.
     	    0=no symbol is to be drawn (line plotting only).
     	   >0=draw symbols together with line segments.
     	   <0=draw symbols only (no line connection between symbols).
            If PM=1 or -1, SM designates the pattern of area fill
     	    and -SM skips outlining the filled area.
     	    If PM=3, SM designates the hatching pattern of bars
     	    and -SM skips connecting line segments between bars.
     	LI: line type from 1 through 9. Refer to the subtopic
     	    LINETYPE_TABLE for type description.
     	    >0=connect data points with straight line segments.
     	    <0=connect data points with spline-smoothed curve.
     	DN: Data point plotting-density/skipping flag.
     	    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: graph band assignment code for the set of data:
     	    1=to be scaled and plotted on the 1st graph band.
     	    2=to be scaled and plotted on the 2nd graph band.
     	    3=to be scaled and plotted on both graph bands.
     	BL: bold-line or linewidth code in number of the default
     	    linewidth.
     	PM: plotting mode for drawing the set of data.
     	    0=regular line and/or symbol plot.
     	    1=regular line plot + area fill to line RL.
     	   -1=regular line plot + close-loop area fill.
     	    2=regular line and/or symbol plot + dropping a vertical
     	      line of type LI to line RL.
     	    3=regular line plot + dropping a vertical bar
     	      of hatching pattern SM and width SS to line RL.
     	SS: size of symbols in inches if symbols are to be plotted.
     	    If PM=3, SS designates the bar width.
     	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 line that 
     	    can be set anywhere along the y-axis.

  LABL= data set ID label for each set of data (max. 75 chars).

  PAR1= DV, NC, LB, PF, XO, YO, XF, YF, LW, VP


     	Hardcopy page setup parameters:

     	DV: hardcopy device intended.
     	    1=HP7550-HPGL series pen plotter.
     	    2=HP7221 series pen plotter.
     	    3=35mm Image/slide maker.
     	    4=Postscript laser printer.
     	NC: number of hardcopy to be made.
     	LB: plot id label drawing flag (0=no, 1=yes).
     	PF: page feed flag (0=no, 1=yes).
     	XO: plot offset in inches in x-direction.
     	YO: plot offset in inches in y-direction.
     	XF: plot overall scale factor in x-dimension.
     	YF: plot overall scale factor in y-dimension.
     	LW: line width in number of the default linewidth.
     	VP: vertical page flag (0=off, 1=on).
     	
  PAR2= PS, FT, BC, RS, RS, RS, RS, RS, RS, RS

     	Hardcopy page setup parameters:

     	PS: pen speed from 1 through 9 for a pen plotter.
     	FT: film type for a 35mm slide maker.
     	    1=Polaroid instant slide film.
     	    2=Ektachrome-100 color slide film.
     	BC: slide background color number.
     	    1=Black, 2=Medium-gray, 3=Dark-blue
     	    4=Medium-blue, 5=Light-gray, 6=Red
     	RS: reserved parameter, not yet implemented.

  IDEN= plot identification label to replace the default filename.

3 Histogram_plot
  Valid data file format (FORMATTED/ASCII file only):

     X(1)  Y(1,1)  Y(2,1)  Y(3,1)  Y(4,1)  ......
     X(2)  Y(1,2)  Y(2,2)  Y(3,2)  Y(4,2)  ......
     X(3)  Y(1,3)  Y(2,3)  Y(3,3)  Y(4,3)  ......
     ......

  where X(I) is any alphanumeric label (max 8 characters allowed) 
  for the group of bars Y(J,I) in the same line, also called the group 
  label. Y(J,I) is the bar height for data point I of data set J and 
  can be positive or zero or negative. Max numbers of data sets (max 
  index J) and data points (max index of I) can not exceed those 
  allowed by the current version of program.

  Example of a valid data file:

     100C 250    355.5 139.2 -220.6 65.7
     200C 330.2  -35.5 239.2  -20.6 55.4
     300C -460    55.5  19.2,     , 45.0
     400C 180.54 -95.5 139.2 -100.6
     500C 250.55 505.5,    ,      , 35.5

  In the example given above, 5 data points for each of 5 sets of 
  bars are to be plotted. Notice that a data file is free of data 
  field formats with a max field length of 40 digits per column. 
  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. Each input 
  line is parsed during the input to get all the input columns. 
  Multiple sets or columns of bars, if any, do not have to have the 
  same number of data points. During plotting, blank or zero height 
  bars are bypassed, and positive and negative bars, if co-existing,
  are plotted in the opposite directions with based line set at 
  coordinate 0.0 on the y-axis. Following file types are searched 
  for a file without type (in precedence from left to right): BAR, 
  DAT, RAW.
3 Contour_Plot
  Valid data format #1 (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)

  Valid data format #2 (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 a file without type 
  (in precedence from left to right): MAP, DAT, RAW.
3 Text_plot
  GRAFIT's text plot simulates DCL RUNOFF procedure to setup a text
  page. As in DCL RUNOFF, a command line must start with a dot "."
  at the 1st column but no text can follow it.
  Following control sequences can be embedded within a text line:

     { --- 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 #.

  Runoff_like commands implemented are listed in the subtopics.
4 .PAGESIZE    
  .PAGESIZE width,height  or  .PS width,height   [8.0,5.0]

  Set page size in inches.
4 .SCALE      
  .SCALE x,y_scale_factor  or  .SC x,y_scale-factor   [1.0,1.0]

  Set overall plot scale factors. If you specify a pagesize beyond
  the screen size (10.0x8.0 inches), use smaller scale factors to
  shrink the page so that you can better preview the page setup.
4 .TOPMARGIN   
  .TOPMARGIN margin    or    .TM margin       [1.0]

  Set page top margin in inches.
4 .LEFTMARGIN  
  .LEFTMARGIN margin   or   .LM margin        [0.5]

  Set page left margin in inches.
4 .SPACING    
  .SPACING line_spacing  or  .SP line_spacing  [0.15]

  Set line spacing in inches for subsequent text lines.
4 .FONT       
  .FONT keyword   or   .FT keyword       [standard]

  Select font type for subsequent text lines where the valid
  font keywords are STANDARD, ITALICS, and BOLDFACE.
4 .SIZE       
  .SIZE width,height  or   .SZ width,height  [0.15,0.15]

  Set text character width and height in inches.
4 .COLOR      
  .COLOR keyword   or  .CL keyword        [green]

  Set drawing pen color for subsequent text lines
  where the valid color keywords are

  BLACK/WHITE, RED, GREEN, BLUE, MAGENTA, PURPLE, YELLOW
4 .RESET      
  .RESET x,y_coordinate   or  .RS x,y_coordinate

  Re_position drawing pen to screen coordinate (x,y) in inches.
  Coordinate (0.0,0.0) is on top_left corner of the screen with
  positive x cross and positive y down the screen. RESET command
  is used mainly for drawing multi_columns of text or a table.
  A RESET command without x,y_coordinate resets drawing pen to
  the lowest or max y_coordinate ever referred to on the page.
4 .CENTER     
  .CENTER x_left,x_right   or   .CT x_left,x_right

  Begin centering for subsequent text lines between coordinate
  points x_left and x-right. If x_left and x_right are not
  specified, the text lines are centered on the page.
  Multi-column text centering can be accomplished combining
  CENTER with RESET command.
4 .ENDCENTER  
  .ENDCENTER    or   .EC

  Stop centering of text lines.
4 .HSPACE     
  .HSPACE width     or    .HS width

  Set horizontal space or indentation to the right in inches
  for subsequent non_centering text lines.
4 .VSPACE     
  .VSPACE height    or   .VS height

  Set vertical space in inches between the last text line
  and the subsequent text lines.
4 .LINE       
  .LINE x1,y1,x2,y2,line_type  or  .LI x1,y1,x2,y2,line_type

  Draw a line of specified type from point (x1,y1) to (x2,y2)
  where the coordinates are in inches and refer to top_left
  corner (0.0,0.0) of the screen.
4 .NEWPAGE    
  .NEWPAGE   or  .NP

  Start a new page for subsequent text lines.
2 Hardcopy     
  Hardcopy making, when requested in GRAFIT, is automatically done in
  the default setup, by spawning a DCL subprocess to a system batch 
  queue using a program-written command file *.BC, where * indicates 
  the name of the data file being plotted. During interactive screen 
  plotting, a hardcopy device independent metafile *.DI is written in 
  your account.  The spawned hardcopy batchjob reads this metafile and 
  converts it to a device dependent file which in turn gets printed to
  a print queue dedicated to the designated hardcopy device. Upon 
  successful completion of the above process, the metafile *.DI is then 
  deleted. This hardcopy making environment requires following command 
  symbols to be defined in your LOGIN.COM before the "$ IF F$MODE()
  .NES."INTERACTIVE" THEN EXIT" line:

  $ SUB_PRINT =="SUBMIT/QUE=BATCH$HARDCOPY/NOPRINT/NOLOG/DELETE/NOID"
  $  HP_PRINT == "PRINT/QUE=HP$PRINT/DELETE"
  $  PS_PRINT == "PRINT/QUE=PS$PRINT/DELETE"
  $  IM_PRINT == "PRINT/QUE=IM$PRINT/DELETE"

  where SUB_PRINT is used to spawn the hardcopy, HP_PRINT is used
  to print the hardcopy on a HP plotter, PS_PRINT on a Postscript
  laser printer, IM_PRINT on a 35mm slide maker, and /QUE should 
  point, as mentioned above, to the appropriate queues setup on 
  your system. /DELETE is recommended if you do not intend to save
  the *.BC and the final hardcopy files. If needed, the print
  symbols can be defined as DCL copy command lines (for example
  to copy a hardcopy file over the local network).

  However a hardcopy destination option is also implemented to 
  allow you to suppress the default printing of a hardcopy as
  described above. The option is accessible on the hardcopy page
  setup menu in interactive plotting, with qualifier /HARDCOPY
  in non-interactive hardcopy making. The optional destination 
  can be specified either as a filename or as a logical device
  address.
2 Qualifiers  
  Qualifiers can be classified into three groups:

  [1] Those apply both for interactive plotting and non-interactive
      hardcopy making:

     	/FUNCTION=keyword
     	/LAYOUT=layout_file
     	/SETUP=setup_file

  [2] Those apply only for interactive plotting:

     	/TERMINAL=keyword
     	/NOHARDCOPY

  [3] Those apply only for non-interactive hardcopy making:

     	/COPIES=number
     	/DEVICE=keyword
     	/HARDCOPY[=destination]
     	/HPAGE
     	/ID[=plot_ID_label]               or  /NOID
     	/OFFSET=(x_offset,y_offset)
     	/PAGE_FEED                        or  /NOPAGE_FEED
     	/PEN_SPEED=number
     	/SCALE=(x_scale,y-scale)
     	/VPAGE

  All qualifiers can be placed anywhere in the command line, entered
  with their own unique abbreviations, and they are case_insensitive.
  When a qualifier is missing in non-interactive hardcopy making mode,
  its default or setup-file value is used. You can also define your 
  own commands to incorporate the desired qualifiers to shorten input 
  command lines (refer to subtopic EXAMPLES for some examples).
/FUNCTION=keyword

  Selects graphics function to perform. The valid keywords are:

     XYPLOT .......... X,Y plot.
     LAYOUT .......... Layout plot.
     CONTOUR ......... Contour plot.
     HISTOGRAM ....... Histogram plot.
     PIECHART ........ Piechart plot.
     TEXTPLOT ........ Text plot.
     FUNCTION ........ Math function plot.
     DIGITIZE ........ Digitization.

  For TEXTPLOT, FUNCTION, and DIGITIZE, parameter P1 and all
  other qualifiers if any (except /TERMINAL) are ignored.
/SETUP=setup_file

  Designates the setup_file to be used.
  The setup_file overrides the default plot setup.
/LAYOUT=layout_file

  Designates the auxiliary layout_file to be used.
  The layout_file overrides the default layout_file.
/TERMINAL=keyword

  Qualifier for interactive screen plotting only.
  Identifies on-line terminal, where the valid keywords are

  TEK4100: Tektronix-4100 graphics terminal, such as a Tek-4015,
           -4107, -4205, -4207. Full graphics functionality is 
           supported on such a terminal.

  REGIS: ReGIS graphics terminal, such as a GIGI, VT330, VT240.
         Following features are not supported on such a terminal:

         o  Function keys F1 through F8.
         o  Graphics input (GIN) or crosshair cursor.
         o  Interactive layout utility.
         o  Continuous font size and direction.
         o  Screen saving or combination plot.

  ANSI: ANSI_protocol text terminal, which observes ANSI escape 
        sequences for alpha-cursor control and character renditions
        such as a VT100 terminal. No screen graphics is supported 
        on such a terminal but you can still perform interactive 
        dialogue and plot setup, and make a hardcopy. In general,
        most of terminals including the graphics terminals listed
        above are VT100 compatible.
/HPAGE         

  Qualifier for non-interactive hardcopy making only.
  Align the horizontal axis of plot with the longer
  edge of the hardcopy page [default plot alignment].
/VPAGE          

  Qualifier for non-interactive hardcopy making only.
  Align the horizontal axis of plot with the shorter
  edge of the hardcopy page.
/PAGE_FEED       
 /NOPAGE_FEED

  Qualifier for non-interactive hardcopy making only.
  Enables or disables a hardcopy page feed. When disabled,
  subsequent plots will be printed on the same hardcopy page.
/PEN_SPEED=number

  Qualifier for non-interactive hardcopy making only.
  Sets drawing pen speed in normalized speed-scale
  1 through 9 on a pen plotter.
/DEVICE=keyword

  Qualifier for non-interactive hardcopy making only.
  Select hardcopy making device. The valid keywords are:

     HP7550 ... Hewlett_Packard HP7550_HPGL Pen Plotter.
     HP7221 ... Hewlett_Packard HP7221_series Pen Plotter.
     SLIDEM ... Presentation Tech. 35mm Color SlideMaker.
     LN03PS ... LN03 Postscript Laser Printer.
/COPIES=number

  Qualifier for non-interactive hardcopy making only.
  Designate number of hardcopies to be made.
  The valid range of numbers is from 1 to 99.
/OFFSET=(x,y_offsets)

  Qualifier for non-interactive hardcopy making only.
  Offsets plot on the hardcopy page from its default
  position where offsets are specified in inches.
/SCALE=(x,y_scales)
  
  Qualifier for non-interactive hardcopy making only.
  Sets plot overall scale factors (>1.0 enlarge) or
  (<1.0 shrink) on the hardcopy page.
/ID[=plot_ID_label]
 /NOID

  Qualifier for non-interactive hardcopy making only.
  A hardcopy is labeled by default with the name of the file
  plotted. This qualifier allows you to override the default
  labeling of a hardcopy.
/HARDCOPY[=destination]
 /NOHARDCOPY

  /HARDCOPY invokes GRAFIT for non-interactive hardcopy making
  where the "destination" can be passed with a filename or a
  logical device address for hardcopy dump or else hardcopy
  is directed to the default print queue.

  /NOHARDCOPY suppresses the default preparation of the device
  independent hardcopy file (*.DI) in order to speed up screen
  plotting. Hardcopy making therefore can not be invoked from
  the interactive dialogue menu later on.

  Refer to subtopic HARDCOPY for more information.
2 Examples   
  Examples of commands to activate GRAFIT:

  $ GRAFIT
  $ GRAFIT/TERM=TEK/FUNC=XYPLOT JUNK.DAT,JUNK1.DAT,JUNK2.DAT
  $ GRAFIT JUNK.DAT/SETUP=BATCH.PAR/LAYOUT=BATCH.DES
  $ GRAFIT JUNK.DAT/HARDCOPY=CADVAX::HP:/DEV=HP7221/SCALE=(0.85,0.85)
  $ XYPLOT == "GRAFIT/TERMINAL=TEK4100/FUNCTION=XYPLOT"
  $ XYPLOT JUNK.DAT,JUNK1.DAT,JUNK2.DAT
  $ HPPLOT == "GRAFIT/HARDCOPY/DEVICE=HP7550/FUNCTION=XYPLOT"
  $ HPPLOT JUNK.DAT,JUNK1.DAT,JUNK2.DAT
