NAME

       hp2ps - convert a heap profile to a POSTSCRIPT graph

SYNOPSIS

       hp2ps [flags] [file][.hp]

DESCRIPTION

       The  program  hp2ps converts a heap profile stored in file into a POSTSCRIPT graph, sending the result to
       file.ps.  By convention, files to be processed by hp2ps have a .hp extension. However, for  compatibility
       with  older  versions  of  hp2ps,  this  extension  can be omitted. If file is omitted entirely, then the
       program behaves as a filter.

OPTIONS

       The flags are:

       -d     In order to make graphs more readable, hp2ps sorts the  shaded  bands  for  each  identifier.  The
              default  sort  ordering is for the bands with the largest area to be stacked on top of the smaller
              ones.  The -d option causes rougher bands (those representing series of values  with  the  largest
              standard deviations) to be stacked on top of smoother ones.

       -b     Normally, hp2ps puts the title of the graph in a small box at the top of the page. However, if the
              JOB string is too long to fit in a small box (more than 35 characters), then hp2ps will choose  to
              use a big box instead. The -b option forces hp2ps to use a big box.

       -e float[in|mm|pt]
              Generate  encapsulated  POSTSCRIPT  suitable  for  inclusion  in  LaTeX  documents.   Usually, the
              POSTSCRIPT graph is drawn in landscape mode in an area 9 inches wide by 6 inches high,  and  hp2ps
              arranges  for  this  area  to  be  approximately  centered  on a sheet of a4 paper. This format is
              convenient of studying the graph in detail, but it is unsuitable for inclusion in LaTeX documents.
              The  -e  option  causes the graph to be drawn in portrait mode, with float specifying the width in
              inches, millimetres or points (the default).   The  resulting  POSTSCRIPT  file  conforms  to  the
              Encapsulated  Post  Script  (EPS)  convention,  and  it  can be included in a LaTeX document using
              Rokicki's dvi-to-POSTSCRIPT converter dvips.  hp2ps requires the width to exceed 2 inches.

       -g     Create output suitable for the gs POSTSCRIPT previewer (or similar). In this  case  the  graph  is
              printed in portrait mode without scaling. The output is unsuitable for a laser printer.

       -p     Use   previous  parameters.  By  default,  the  POSTSCRIPT  graph  is  automatically  scaled  both
              horizontally and vertically so that it fills the page.  However, when preparing a seires of graphs
              for  use  in  a presentation, it is often useful to draw a new graph using the same scale, shading
              and ordering as a previous one. The -p flag causes the graph to  be  drawn  using  the  parameters
              determined by a previous run of hp2ps on file.

       -s     Use a small box for the title.

       -y     Draw the graph in the traditional York style, ignoring marks.

       -c     Use colours in the rendering of the graphs.

       -?     Print out usage information.

INPUT FORMAT

       The format of a heap profile is best described by example:

              JOB "a.out -p"
              DATE "Fri Apr 17 11:43:45 1992"
              SAMPLE_UNIT "seconds"
              VALUE_UNIT "bytes"
              BEGIN_SAMPLE 0.00
                SYSTEM 24
              END_SAMPLE 0.00
              BEGIN_SAMPLE 1.00
                elim 180
                insert 24
                intersect 12
                disin 60
                main 12
                reduce 20
                SYSTEM 12
              END_SAMPLE 1.00
              MARK 1.50
              MARK 1.75
              MARK 1.80
              BEGIN_SAMPLE 2.00
                elim 192
                insert 24
                intersect 12
                disin 84
                main 12
                SYSTEM 24
              END_SAMPLE 2.00
              BEGIN_SAMPLE 2.82
              END_SAMPLE 2.82

SEE ALSO

       dvips(1), latex(1), hbchp (1), lmlchp(1)
       C.  Runciman  and D. Wakeling, Heap Profiling for Lazy Functional Languages, YCS-172, University of York,
       1992

NOTES

       POSTSCRIPT is a registered trademark of Adobe Systems Incorporated.

AUTHOR

       David Wakeling of the University of York.

                                                  18 April 1992                                         HP2PS(1)