Provided by: lmbench-doc_3.0-a7-1ubuntu1_all bug

NAME

       bargraph - compile bar graphs into pic input

SYNOPSIS

       bargraph [ filename ...  ]

DESCRIPTION

       bargraph  is  a perl script which takes a set of Y data with labels and
       generates a (human readable) pic  script  that  will  produce  the  bar
       graph.   The  output (pic input) is commented and is designed such that
       you should be able to go in and adjust it to fit your  document  should
       you need to do so.

       The input data format is:

           3 foo bar
           9 bigger foo
           "Silly example

       with output like

                             bigger
                              foo
                          +----------+
                          |          |
               foo        |          |
               bar        |          |
           +----------+   |          |
           |          |   |          |
           +----------+   +----------+
         -------------------------------
                3              9

                 Silly example

OPTIONS

       The following command line options are available

       -big      Make the x/y defaults be 7.5 inches, crank up the title size,
                 and don’t put a spacer at the top.  Used for printing a graph
                 on a full page.

       -nobox    Do not put an outline box around the bargraph.

CONTROL OPTIONS

       The following may be included in the graph to control the format of the
       graph.  They must be at the beginning of a line and by themselves.

       %ps <ps>          point size.  Default is 10.

       %ft <ft>          font.  Default is CB.

       %labelgap <val>   the space in inches between fill  labels.   The  bars
                         may be filled with different fill values (no patterns
                         yet, pic doesn’t do that).   If  you  want  to  label
                         these, the labels are labelgap inches apart.  Default
                         is 1.5 inches.

       %xsize <val>      the width of the  graph  in  inches.   Default  is  7
                         inches.

       %ysize <val>      the  height  of  the  graph  in inches.  Default is 6
                         inches.

       %Title n|s <title>
                         the title of  the  bargraph.   The  title  option  is
                         followed  by  a  a  "n"orth (top) or "s"outh (bottom)
                         indicator which controls placement of the title.   No
                         default.

       %titleplus <val>  increases   the  size  of  the  title  in  pointsize.
                         Default is 0.

       %boxpercent <val> a value between 0 and 100 that controls  how  closely
                         the bars are to each other.  A value of 100 means the
                         bars touch.  Default is 75.

       %worse <D> <W>    An idiot arrow is drawn  to  indicate  which  way  is
                         worse.   <D>  is  the  direction  and must be "up" or
                         "down".  <W> is the location specifier  and  must  be
                         one   of   "n"orth,  "w"est,  "e"ast,  "s"outh,  "nw"
                         northwest, ne, sw, se, etc.

       %better <D> <W>   An idiot arrow is drawn  to  indicate  which  way  is
                         better.   <D>  is  the  direction and must be "up" or
                         "down".  <W> is the location specifier  and  must  be
                         one   of   "n"orth,  "w"est,  "e"ast,  "s"outh,  "nw"
                         northwest, ne, sw, se, etc.

       %fakemax          pretend  that  one  data  point  was  this  big  when
                         autoscaling.   THis  is  used  to  make  a  series of
                         bargraphs be all drawn to the same scale.

FILL CONTROL

       Each datum may be follwed by a fill specifier as follows
            3 foo bar %fill.5
       Labels may be specified to group a set of data that all have  the  same
       data.  If a line appears like
            %label.5 The foo bar data
       then you get a label below the graph.

SEE ALSO

       gtroff(1), graph(1), gpic(1)

TODO

       Make a -horizontal option that prints the graphs the other way.

       Hack pick to get access to postscripts stipple patterns.

BUGS

       This  isn’t done.  It isn’t integrated with the groff preprocessor yet.
       It doesn’t know about .GS/.GE thingys.  I use it to manually generate a
       pic  file  and then include that.  I have to talk to James to see if he
       wants it as part of the gpic stuff.

                                                                   BARGRAPH(1)