dgtst(1) PT-Scotch user's manual dgtst(1)NAMEdgtst - test the consistency of source graphs in parallel
SYNOPSISdgtst [options] [gfile] [lfile]
DESCRIPTION
The dgtst program checks, in a parallel way, the consistency of a
Scotch source graph and, in case of success, outputs some statistics
regarding edge weights, vertex weights, and vertex degrees.
It produces the very same results as the gtst(1) program of the Scotch
sequential distribution, but unlike this latter it can handle distrib‐
uted graphs.
Source graph file gfile is either a centralized graph file, or a set of
files representing fragments of a distributed graph. The resulting sta‐
tistics are stored in file lfile. When file names are not specified,
data is read from standard input and written to standard output. Stan‐
dard streams can also be explicitly represented by a dash '-'.
When the proper libraries have been included at compile time, dgtst can
directly handle compressed graphs, both as input and output. A stream
is treated as compressed whenever its name is postfixed with a com‐
pressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The com‐
pression formats which can be supported are the bzip2 format ('.bz2'),
the gzip format ('.gz'), and the lzma format ('.lzma', on input only).
dgtst bases on implementations of the MPI interface to spread work
across the processing elements. It is therefore not likely to be run
directly, but instead through some launcher command such as mpirun.
OPTIONS-h Display some help.
-rpnum Set root process for centralized files (default is 0).
-V Display program version and copyright.
EXAMPLE
Run dgtst on 5 processing elements to test the consistency of graph
brol.grf
$ mpirun -np 5 dgtst brol.grf
Run dgord on 5 processing elements to test the consistency of a dis‐
tributed graph stored on graph fragment files brol5-0.dgr to
brol5-4.dgr, and save the resulting ordering to file brol.ord (see
dgscat(1) for an explanation of the '%p' and '%r' sequences in names of
distributed graph fragments).
$ mpirun -np 5 dgtst brol%p-%r.dgr brol.ord
SEE ALSOdgscat(1), gtst(1), dgord(1).
PT-Scotch user's manual.
AUTHOR
Francois Pellegrini <francois.pellegrini@labri.fr>
February 14, 2011 dgtst(1)
