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

<?><?><?> (NAME)
       dggath, dgscat, gscat - <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       dggath [options] [igfile] [ogfile]

       dgscat [options] [igfile] [ogfile]

       gscat [options] [igfile] [ogfile]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> dggath <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (gather) <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> igfile
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> ogfile <?><?><?><?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> dgscat <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> (scatter) <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> igfile <?><?> <?><?><?><?><?><?><?><?>
       <?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> ogfile <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> gscat <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> dgscat <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?> <?><?><?><?> <?><?> gscat
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <<->> <?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> dggath <?> dgscat <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> "brol.grf.bz2" <?><?>
       "-.gz"<?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?>: <?><?><?><?> bzip2 (<?><?><?><?><?>
       ".bz2")<?> <?><?><?><?> gzip (<?><?><?><?><?> ".gz") <?> <?><?><?><?>
       lzma (<?><?><?><?><?> ".lzma").

       <?><?><?><?><?><?><?><?><?><?> dggath <?> dgscat <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> MPI <?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> mpirun
       <?><?><?><?> <?><?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> (DISTRIBUTED
       FILE NAMES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>/<?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <<%>> <?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       (root processor) <?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> 0 <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (communicator)
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> -r <?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?>.

       %p     <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?>
              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       %r     <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> (rank) <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

       %-     <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?>
              <?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> (<?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <<%r>> <?><?><?><?><?> <?><?><?><?>).

       %%     <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <<%>>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?> "brol"
       <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?> "brol"
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?> "%-brol" (<?><?>
       <?><?><?> "br%-ol") <?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> "brol"
       <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?> <?><?><?> <?><?><?><?> "brol%p-%r" <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       "brol2-0" <?> "brol2-1" <?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -c     <?><?><?><?> <?><?><?><?> dggath <?> dgscat. <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?>.

       -h     <?><?><?><?><?> <?><?><?><?><?><?>.

       -i nbr <?><?><?><?> <?><?><?><?> gscat. <?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> extit{nbr}
              <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?>.

       -r pnum
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?><?><?> 0 <?><?><?>).

       -V     <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
              <?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> dgscat <?><?> <?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> brol.grf <?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> gzip
       <?><?> brol5-0.dgr.gz <?><?> brol5-4.dgr.gz.

           $ mpirun -np 5 dgscat brol.grf brol%p-%r.dgr.gz


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       dgmap(1), dgord(1), dgtst(1), gmk_hy(1).

       <?><?><?><?><?><?><?> <?><?><?><?><?><?> PT-Scotch.

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Francois Pellegrini <francois.pellegrini@labri.fr>

                                05 August 2023                       dgscat(1)