1
2gmtst(1)                     Scotch user's manual                     gmtst(1)
3
4
5

NAME

7       gmtst - compute statistics on mappings
8

SYNOPSIS

10       gmtst [options] [gfile] [tfile] [mfile] [lfile]
11

DESCRIPTION

13       The gmtst program computes, in a sequential way, statistics on a static
14       mapping, such as load imbalance ratio, edge dilation distribution, etc.
15       It  yields  the  same results as the ones produced by the -vm option of
16       the gmap(1) program.
17
18       Source graph file gfile can only be  a  centralized  graph  file.  File
19       tfile  represents  the target architecture onto which gfile was mapped.
20       If mapping file mfile was produced by gpart(1), the target architecture
21       file  to  provide  gmtst should describe a complete graph with the same
22       number of vertices as the requested number of parts,  for  instance  by
23       means  of  the  'cmplt num' algorithmically-described architecture. The
24       resulting statistics are stored in file lfile. When file names are  not
25       specified,  data  is  read  from standard input and written to standard
26       output. Standard streams can also be explicitly represented by  a  dash
27       '-'.
28
29       When  the proper libraries have been included at compile time, gtst can
30       directly handle compressed graphs, both as input and output.  A  stream
31       is  treated  as  compressed  whenever its name is postfixed with a com‐
32       pressed file extension, such as in 'brol.grf.bz2' or '-.gz'.  The  com‐
33       pression  formats which can be supported are the bzip2 format ('.bz2'),
34       the gzip format ('.gz'), and the lzma format ('.lzma', on input only).
35

OPTIONS

37       -h     Display some help.
38
39       -V     Display program version and copyright.
40

EXAMPLES

42       Display statistics on mapping brol.map of graph  brol.grf  onto  target
43       architecture brol.tgt:
44
45           $ gmtst brol.grf brol.tgt brol.map
46
47       Display  statistics on partitioning brol.map of graph brol.grf into num
48       parts. Note the use of  the  complete  graph  algorithmically-described
49       architecture and of the shell pipe command to provide the complete tar‐
50       get architecture description on the standard input of  the  gmtst  com‐
51       mand:
52
53           $ echo "cmplt num" | gmtst brol.grf - brol.map
54
55

SEE ALSO

57       gmap(1), gout(1), gtst(1).
58
59       Scotch user's manual.
60

AUTHOR

62       Francois Pellegrini <francois.pellegrini@labri.fr>
63
64
65
66                                August 03, 2010                       gmtst(1)
Impressum