1
.\" Text automatically generated by txt2man
2
.TH ptscotch_dgtst 1 "June 05, 2008" "" "PT-Scotch user's manual"
4
\fBptscotch_dgtst \fP- test the consistency of Scotch source graphs in parallel
9
\fBptscotch_dgtst\fP [\fIoptions\fP] [\fIgfile\fP] [\fIlfile\fP]
13
The \fBptscotch_dgtst\fP program checks, in a parallel way, the consistency of a
14
source graph, and outputs some statistics regarding edge weights,
15
vertex weights, and vertex degrees in case of success.
17
It produces the very same results as the \fBgtst\fP(1) program of the
18
Scotch sequential distribution, but unlike this latter it can handle
21
Source graph file \fIgfile\fP is either a centralized graph file, or a set
22
of files representing fragments of a distributed graph. The
23
resulting statistics are stored in file \fIlfile\fP. When file names are
24
not specified, data is read from standard input and written to
25
standard output. Standard streams can also be explicitly
26
represented by a dash '-'.
28
When the proper libraries have been included at compile time, \fBptscotch_dgtst\fP
29
can directly handle compressed graphs, both as input and output. A
30
stream is treated as compressed whenever its name is postfixed with
31
a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
32
compression formats which can be supported are the bzip2 format
33
('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
36
\fBptscotch_dgtst\fP bases on implementations of the MPI interface to spread work
37
across the processing elements. It is therefore not likely to be run
38
directly, but instead through some launcher command such as \fBmpirun\fP.
47
Set root process for centralized files (default is 0).
51
Display program version and copyright.
53
Run \fBptscotch_dgtst\fP on 5 processing elements to test the consistency of graph brol.grf
57
$ mpirun -np 5 ptscotch_dgtst brol.grf
61
Run dgord on 5 processing elements to test the consistency of a
62
distributed graph stored on graph fragment files brol5-0.grf to
63
brol5-4.grf, and save the resulting ordering to file brol.ord (see
64
\fBdgscat\fP(1) for an explanation of the '%p' and '%r' sequences in names
65
of distributed graph fragments).
69
$ mpirun -np 5 ptscotch_dgtst brol%p-%r.grf brol.ord
74
\fBptscotch_dgscat\fP(1), \fBptscotch_gtst\fP(1), \fBptscotch_dgord\fP(1).
76
PT-Scotch user's manual.
78
Francois Pellegrini <francois.pellegrini@labri.fr>