NAME

     bspsig - Generate a signature from a BSP profile

SYNOPSIS

     bspsig [-v] [-help] [-wfm] [-sig]  [-stat]  [-sort  key]  [-
     bucket  size]  [-compress  size]  [-ignore percentage] [-slg
     bsp-parameters] filename

DESCRIPTION

     Generate a profile and cost signature  for  the  trace  file
     filename.  Trace  files are generated by adding the option -
     prof when compiling BSPlib programs with bspfront(1).

OPTIONS

     -v    Print (on standard error output) the  phases  involved
          in  the  execution  of  the  profiler.  The option also
          prints the version number of the profiler.

     -help
          Print this manual page on standard output.

     -bucket size
          The profiler generates  an  entry  for  each  different
          sized  h-relation  generated by the same textual super-
          step. The -bucket option, combines h-relations from the
          same superstep that are size apart.

     -compress size
          This option repeatedly compresses the size of the  pro-
          file until at most size entries remain.

     -ignore percent
          Ignore all cost centres for which both the  computation
          and  communication account for less then percent of the
          total cost.

     -wfm  Use an alternative format for displaying the output.

     -sig  Similar to - wfm  except  entries  with  the  same  h-
          relation  size  are  merged.  Use an alternative format
          for displaying the output.


     -stat
          Prints the following accumulated h-relation statistics:

          Max supersteps
               the normal BSP interpretation of h-relation cost;

          Max async
               costs the comunication as though the  program  was
               running with no superstep structure;

          Volume
               costs average h-relation size in each superstep;

          Min async
               minimum total communication by any processor;

          Min supersteps
               costs mimimum h-relation size in each superstep.


     -slg s,l,g[,nhalf]
          When generating the profile, the options to  - slg  are
          numbers which represent the BSP parameters:

          s    is the Megaflop/s rating for the machine.

          l    the minimum number of flops  for  a  barrier  syn-
               chronisation.

          g    the asymptotic number of flops  required  for  all
               processors  to  communicate a single 32bit word to
               another process.

          nhalf
               the number of words required for the communication
               performance to deteriorate to 2g.
     See bspparam(1) for information concerning the BSP parameter
     database.

     -sort key
          The profile is sorted using key; where key is one of:

          commtheory
               Theoretical communication cost  [default].

          hrel Size of h-relation.

          syncs
               The number of times  a  particular  superstep  was
               executed.

          commreal
               The actual communication cost.

          delta
               The difference between the theoretical and  actual
               communication costs.

          comptime [or w]
               Computation time.

          rcomptheory
               Ratio of computation to theoretical  communication
               cost.

          rcompreal
               Ratio of computation to actual communication time.

          w/h  Ratio of work to h-relatin size

          w/syncs
               Ratio of work to number of synchronisations.

SEE ALSO

     bsplib(3), bspfront(1), bsparch(1)

     The Oxford BSP toolset web pages can be found  at:
     http://www.bsp-worldwide.org/implmnts/oxtool/

BUGS

     Problems  and  bug  reports  should  be  mailed  to  bsplib-
     bugs@comlab.ox.ac.uk

AUTHORS

     Jonathan.Hill@comlab.ox.ac.uk

     http://www.comlab.ox.ac.uk/oucl/people/jonathan.hill.html