1dgtst(1)                    PT-Scotch user's manual                   dgtst(1)
2
3
4

NAME

6       dgtst - test the consistency of source graphs in parallel
7

SYNOPSIS

9       dgtst [options] [gfile] [lfile]
10

DESCRIPTION

12       The  dgtst  program  checks,  in  a  parallel way, the consistency of a
13       Scotch source graph and, in case of success,  outputs  some  statistics
14       regarding edge weights, vertex weights, and vertex degrees.
15
16       It  produces the very same results as the gtst(1) program of the Scotch
17       sequential distribution, but unlike this latter it can handle  distrib‐
18       uted graphs.
19
20       Source graph file gfile is either a centralized graph file, or a set of
21       files representing fragments of a distributed graph. The resulting sta‐
22       tistics  are  stored  in file lfile. When file names are not specified,
23       data is read from standard input and written to standard output.  Stan‐
24       dard streams can also be explicitly represented by a dash '-'.
25
26       When the proper libraries have been included at compile time, dgtst can
27       directly handle compressed graphs, both as input and output.  A  stream
28       is  treated  as  compressed  whenever its name is postfixed with a com‐
29       pressed file extension, such as in 'brol.grf.bz2' or '-.gz'.  The  com‐
30       pression  formats which can be supported are the bzip2 format ('.bz2'),
31       the gzip format ('.gz'), and the lzma format ('.lzma', on input only).
32
33       dgtst bases on implementations of the  MPI  interface  to  spread  work
34       across  the  processing  elements. It is therefore not likely to be run
35       directly, but instead through some launcher command such as mpirun.
36

OPTIONS

38       -h     Display some help.
39
40       -rpnum Set root process for centralized files (default is 0).
41
42       -V     Display program version and copyright.
43

EXAMPLE

45       Run dgtst on 5 processing elements to test  the  consistency  of  graph
46       brol.grf
47
48             $ mpirun -np 5 dgtst brol.grf
49
50       Run  dgord  on  5 processing elements to test the consistency of a dis‐
51       tributed  graph  stored  on  graph  fragment   files   brol5-0.dgr   to
52       brol5-4.dgr,  and  save  the  resulting  ordering to file brol.ord (see
53       dgscat(1) for an explanation of the '%p' and '%r' sequences in names of
54       distributed graph fragments).
55
56             $ mpirun -np 5 dgtst brol%p-%r.dgr brol.ord
57
58

SEE ALSO

60       dgscat(1), gtst(1), dgord(1).
61
62       PT-Scotch user's manual.
63

AUTHOR

65       Francois Pellegrini <francois.pellegrini@labri.fr>
66
67
68
69                               November 03, 2008                      dgtst(1)
Impressum