1gmtst(1) Scotch user's manual gmtst(1)
2
6 gmtst - compute statistics on mappings
7
9 gmtst [options] [gfile] [tfile] [mfile] [lfile]
10
12 The gmtst program computes, in a sequential way, statistics on a static
13 mapping, such as load imbalance ratio, edge dilation distribution, etc.
14 It yields the same results as the ones produced by the -vm option of
15 the gmap(1) program.
16 Source graph file gfile can only be a centralized graph file. File
18 tfile represents the target architecture onto which gfile was mapped.
19 If mapping file mfile was produced by gpart(1), the target architecture
20 file to provide gmtst should describe a complete graph with the same
21 number of vertices as the requested number of parts, for instance by
22 means of the 'cmplt num' algorithmically-described architecture. The
23 resulting statistics are stored in file lfile. When file names are not
24 specified, data is read from standard input and written to standard
25 output. Standard streams can also be explicitly represented by a dash
26 '-'.
27 When the proper libraries have been included at compile time, gtst can
29 directly handle compressed graphs, both as input and output. A stream
30 is treated as compressed whenever its name is postfixed with a com‐
31 pressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The com‐
32 pression formats which can be supported are the bzip2 format ('.bz2'),
33 the gzip format ('.gz'), and the lzma format ('.lzma', on input only).
34
36 -h Display some help.
37 -V Display program version and copyright.
39
41 Display statistics on mapping brol.map of graph brol.grf onto target
42 architecture brol.tgt:
43 $ gmtst brol.grf brol.tgt brol.map
45 Display statistics on partitioning brol.map of graph brol.grf into num
47 parts. Note the use of the complete graph algorithmically-described
48 architecture and of the shell pipe command to provide the complete tar‐
49 get architecture description on the standard input of the gmtst com‐
50 mand:
51 $ echo "cmplt num" | gmtst brol.grf - brol.map
53
56 gmap(1), gout(1), gtst(1).
57 Scotch user's manual.
59
61 Francois Pellegrini <francois.pellegrini@labri.fr>
62 September 08, 2008 gmtst(1)