.HELP:
HISTOGRAM or BAR 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 HISTOGRAM, 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.

Run-time dynamic memory allocation is implemented for data storage.
Allocate the desired amount of storage space before a plot session
using auxiliary dialogue command ALLOCATE. Enter "HELP COMMANDS" to
to get a list of command definitions on auxiliary dialogue commands.

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" or "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" or "NO=N" where N is the sequence 
number of a data set to be displayed.

Enter "GO" to start plotting on screen.
.COMMANDS:
Auxiliary dialogue commands for HISTOGRAM:

EXIT or QUIT   : Exit from Histogram.
GO             : Start plotting on screen.
ALLOCATE p1,p2 : Allocate data storage space for the plot session,
                 where p1 is the max number of data sets and p2 the
                 max number of bars per data set.
LIST           : List all data set parameters.
DOWN or PF1    : Step active data set pointer down by one.
UP   or PF3    : Step active data set pointer up by one.
DCL or PF4     : 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.
REFRESH or MENU: Refresh the dialogue menu if necessary.
TIME           : Display the system clock.
RESET          : Reset graph to the default setup.
SAVE  filename : Save current plot setup or parameters in a file.
OVERLAY or INCLUDE filename: Overlay another data file, same as F2=filename.
.MENU:
Following function keys are defined for local branching:

0: Exit from Histogram.
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.
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.
RETURN: Invoke the dialogue prompt (BARPLT>) without the dialogue menu.
     You can perform plot setup just as you would do with the dialogue 
     menu and all auxiliary dialogue commands are executable.

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

Valid Data 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 bar heights are bypassed and 
positive and negative bars, if co-existing, are plotted in the opposite 
directions with based line set at 0.0 coordinate on the y-axis.

Following file types are searched for for a file without type
(in precedence from left to right): *.BAR, *.DAT, *.RAW.
.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 HISTOGRAM 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 HISTOGRAM,
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 HISTOGRAM 
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 HISTOGRAM:

     { --- 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 (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 HISTOGRAM:

     { --- 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 (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 HISTOGRAM:

     { --- 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 histogram as well as from other functional routines such as contour
plot, xyplot, piechart plot, etc.
.BC:
Bar group configuration code. For a multiple data set plot, two
configurations are implemented for drawing a group of bars using
the following keywords:

    SIDE: group bars are plotted side by side
   STACK: group bars are plotted stacking on top of one another.

For a SIDE configuration, different bar widths could be specified
for different sets of bars; but only the bar width of the 1st set
of bars is used for a STACK configuration.
.BP:
Position code for drawing the group labels. The valid keywords are:

    BOTTOM: group labels are positioned at the bottom of plot.
       TOP: group labels are positioned at the top of each group.
      SKIP: skip drawing the group labels.

For TOP choice, group labels are drawn on the positive tops
if both positive and negative tops co-exist.
.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 LP for where to position the labels.
.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.
.T2:
Axis setup (axis-type, divisions, sub-divisions, scale-digits, axis-pattern).

TY: The valid types of axis are: 1=linear, 2=Log10.
    Every time you touch the axis type, an automatic data scaling
    is performed using full range data points of data.

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 T2,X2,S2 instead.
.X2:
Axis setup (axis-length, 1st-major-tickmark-offset).

XLENG: X-axis length in inches. A negative length skips drawing the axis.
YLENG: Y-axis length in inches. A negative length skips drawing the axis.
 TOFF: offset in inches of the 1st and the last major tickmarks
       away from the end points of the Y-axis.
.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 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 DIV 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 bars.
A zero pen number skips drawing the set of bars.

You can edit data set drawing parameters only in column-run mode using
the following 2 letter access-codes designated for the columns:

           PN, PT, LI, BL, SE, WD, XO, YO, YS

Examples:  PN=2 3 4 5      WD=0.05,,,0.05 0.1

where the 1st number after the equal sign is for the 1st set of bars,
and the 2nd number for the 2nd set of bars etc., STARTING FROM THE 
ACTIVE DATA SET NUMBER. 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,4R4  (equivalent to PN=,,,2,3,4,2,3,4,....,2,3,4).
       WD=0.05I3   (equivalent to SS=,,0.05)

where letter "R" signifies repeating the entry unit, "I" for jumping
to, and the number following "R" or "I" designates the starting data
set number to change.
.PT:
Bar hatching pattern number the set of bars.
Area-fill/hatching pattern table:

      0> hatching off, hollow bar 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).
.LI:
Line type for drawing the set of bars:

     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.
.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.
.SQ:
The default sequence of bars plotted in a group of bars for multiple
data set input is the same as the column sequence in the input file.
To resequence the bars in the group, enter the sequence number as
desired (e.g. 2,1,3,4...).
.WD:
Bar width in inches for drawing the set of bars (range: 0.02 to 5.0 inches).
Multiple sets of bars, if plotted side by side, could have different bar 
widths; if stacked-up, only the bar width of the 1st set of bars is used. 
If current x-axis length isn't long enough to hold all the bars in the 
specified bar widths, bar width are reduced, and if less than 0.02 inches,
x-axis is then elongated accordingly; and the 1st bar offset BO and the
bar-group spacing BS are then set to bar width.
.XO:
Offset in inches from the calculated position along x-axis for drawing
the set of bars. A positive value of offset shifts the bars to the right 
and a negative value to the left.
.YO:
Offset in inches from the calculated position along y-axis for drawing
the set of bars. A positive value of offset shifts the bars up and a 
negative value down.
.ID:
Data set identification label for the active set of bars that is being 
displayed. To edit or enter ID for other set of bars, use commands F1, 
F2, and NO=N to bring the desired set of bars into the display window.
