dgtst(1) [debian man page]

dgtst(1)						      PT-Scotch user's manual							  dgtst(1)

NAME

       dgtst - test the consistency of source graphs in parallel

SYNOPSIS

       dgtst [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  dis-
       tributed graphs.

       Source  graph file gfile is either a centralized graph file, or a set of files representing fragments of a distributed graph. The resulting
       statistics are stored in file lfile. When file names are not specified, data is read from standard input and written  to  standard  output.
       Standard 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 compressed file extension, such as in 'brol.grf.bz2' or  '-.gz'.  The
       compression  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  distributed 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 ALSO

       dgscat(1), gtst(1), dgord(1).

       PT-Scotch user's manual.

AUTHOR

       Francois Pellegrini <francois.pellegrini@labri.fr>

								 February 14, 2011							  dgtst(1)

Check Out this Related Man Page

gmtst(1)						       Scotch user's manual							  gmtst(1)

NAME

       gmtst - compute statistics on mappings

SYNOPSIS

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

DESCRIPTION

       The  gmtst program computes, in a sequential way, statistics on a static mapping, such as load imbalance ratio, edge dilation distribution,
       etc. It yields the same results as the ones produced by the -vm option of the gmap(1) program.

       Source graph file gfile can only be a centralized graph file. File tfile represents the target architecture onto which gfile was mapped. If
       mapping	file  mfile was produced by gpart(1), the target architecture file to provide gmtst should describe a complete graph with the same
       number of vertices as the requested number of parts, for instance by means of the 'cmplt num' algorithmically-described	architecture.  The
       resulting  statistics are stored in file lfile. When file names are not specified, data is read from standard input and written to standard
       output. Standard streams can also be explicitly represented by a dash '-'.

       When the proper libraries have been included at compile time, gtst can directly handle compressed graphs,  both	as  input  and	output.  A
       stream  is  treated as compressed whenever its name is postfixed with a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
       compression formats which can be supported are the bzip2 format ('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma',  on  input
       only).

OPTIONS

       -h     Display some help.

       -V     Display program version and copyright.

EXAMPLES

       Display statistics on mapping brol.map of graph brol.grf onto target architecture brol.tgt:

	   $ gmtst brol.grf brol.tgt brol.map

       Display	statistics on partitioning brol.map of graph brol.grf into num parts. Note the use of the complete graph algorithmically-described
       architecture and of the shell pipe command to provide the complete target architecture description on the standard input of the gmtst  com-
       mand:

	   $ echo "cmplt num" | gmtst brol.grf - brol.map

SEE ALSO

       gmap(1), gout(1), gtst(1).

       Scotch user's manual.

AUTHOR

       Francois Pellegrini <francois.pellegrini@labri.fr>

								 February 14, 2011							  gmtst(1)

Linux and UNIX Man Pages

dgtst(1) [debian man page]

Check Out this Related Man Page