Provided by: lmbench-doc_3.0-a9-1_all bug

NAME

       pgraph - compile graphs into pic input

SYNOPSIS

       pgraph [ options ] [ filename ...  ]

DESCRIPTION

       pgraph  is  a  perl script which takes sets of X Y data and generates a
       (human readable) pic program that will produce the graphed  data.   The
       output  is designed such that you can save it in a file and tweak it to
       make it fit your document.  Try one and look at the output.  The output
       is actually commented.

       The graph is autosized and auto ticked.

       The  input  data  format  is  similar  that of xgraph(1), i.e., "sloped
       across 1 1 2 2 3 3

       "straight across 1 4 2 4 3 4

CONTROL OPTIONS

       You may set the graph title, the X title, and  the  Y  title  with  the
       following  control  sequences  in the data stream: %T Graph title in +4
       point font %X X axis title and/or units in +2  point  font  %Y  Y  axis
       title  and/or units in +2 point font %fakemax-X <value>     force graph
       to be that big %fakemax-Y  <value>      force  graph  to  be  that  big
       %fakemin-X  <value>     force graph to be that small %fakemin-Y <value>
       force graph to be that small

OPTIONS

       -rev        reverse X/Y data sense (and titles).   Note  this  is  done
                   after  processing  any  fudging of the input data stream(s)
                   (see -xk, -yk, -logx, etc below).

       -below      put data set titles below the  graph  rather  than  to  the
                   right.

       -close      no extra space around the data's endpoints.

       -qline      connect the quartile center points.

       -grid       dotted line grid marks.

       -nobox      no box around whole graph.

       -big        make  the  graph take the whole page, and be about 8 inches
                   tall by 7 inches wide and the title is +8 points.

       -slide      make the graph be 4.25 inches square to fit in slides, in a
                   helvetica bold 10 point font.

       -small      make  the  graph be small, 1.75 inches square, and use an 8
                   point bold font.

       -grapheach  draw each data set in its own graph.

       -nolabels   no X/Y/Title labels.

       -notitle    no Title label.

       -nodatal    no data set labels.

       -nomarks    do  not  mark  each  data  point  with   distinct   markers
                   (endpoints are still marked).

       -k          print values larger than 1000 as value/1000.

       -xk         multiply X input by 1024 (blech).

       -yk         multiply Y input by 1024 (blech).

       -xm         multiply X input by 1024*1024 (blech).

       -ym         multiply Y input by 1024*1024 (blech).

       -logx       convert X input into log base 2 of X input.

       -logy       convert Y input into log base 2 of Y input.

EXAMPLE

       Workstation  price  performance  from a Digital ad.  Process with graph
       -rev workstations | groff -TX75

       %T Workstation Price / Performance, 6/93 %X SPECINT 92  Performance  %Y
       Price in $1000's "Dec AXP line 35 5 65 10 78 15 110 70

       "Sun SPARC line 25 4 25 8 38 16 48 21 52 23 64 27

QUARTILE FORMAT

       Data  points are x y1 y2 y3 y4 y5.   You get a two lines from the first
       two y values, a mark at the third, and another line from the last two.

SEE ALSO

       gtroff(1), gpic(1), perl(1).

BUGS

       -grapheach assumes the set of N graphs will fit on one page.

       Since it is just a simple perl script, I tend to be  constantly  adding
       one  more feature on the fly.  Consult the script for the latest set of
       options.  Development is typically done by using  the  closest  set  of
       options  to  generate the graph, massage the graph to do what you want,
       then add that set of changes as a new option.

       This isn't done as much as I would like.  It isn't integrated with  the
       groff  preprocessor  yet.  It doesn't know about .GS/.GE things.  I use
       it to manually generate a pic file and then include that.

       I need to include some example data sets with pgraph.