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

<?><?><?> (NAME)
       dgmap, dgpart - <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       dgmap [options] [gfile] [tfile] [mfile] [lfile]

       dgpart [options] [nparts/pwght] [gfile] [mfile] [lfile]


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> dgmap <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> dgpart <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> dgmap <?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> -b <?> -c <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>. <?><?><?><?><?><?> -m <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> -q <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?> <?><?><?><?><?>
       dgmap <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?> <?><?><?><?> gfile <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?> dgmap<?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       tfile <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> (meshes) <?>
       <?><?><?><?><?><?><?><?><?><?> (hypercubes)<?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> amk_grf(1) <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> gmap(1) <?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       mfile <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> -v) <?><?> <?><?><?><?> lfile <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <<->> <?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> dgmap <?> dgpart
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>. <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       "brol.grf.bz2" <?><?> "-.gz"<?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> bzip2 (<?><?><?><?><?>
       ".bz2")<?> <?><?><?><?> gzip (<?><?><?><?><?> ".gz") <?> <?><?><?><?>
       lzma (<?><?><?><?><?> ".lzma").

       <?><?><?><?><?><?><?><?><?><?> dgmap <?> dgpart <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> MPI
       <?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> mpirun <?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -b val <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?> -m
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.

       -c opt <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>:

              b      <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?>
                     <?><?><?><?><?>.

              q      <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
                     <?><?><?><?> (<?><?><?><?><?><?><?>).

              s      <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
                     <?><?><?><?><?>.

              t      <?><?><?><?><?> <?><?><?><?><?>.

              x      <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.

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

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

              -m strat
                     <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?><?> strat (<?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?><?><?><?> PT-Scotch <?><?>
                     <?><?><?><?><?><?>).

              -q     (<?><?><?><?> dgpart)

              -q pwght
                     (<?><?><?><?> dgmap) <?><?><?><?><?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
                     <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
                     <?><?><?><?>. <?><?><?><?> dgpart<?> <?><?><?><?><?>
                     <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>.
                     <?><?><?><?> dgmap<?> <?><?><?> <?><?><?> pwght
                     <?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
                     <?><?><?>.

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

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

              -v verb
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
                     verb. <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
                     <?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
                     <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
                     <?><?><?> <?><?><?><?>:

                     m      <?><?><?><?><?><?><?> <?><?><?><?><?>.

                     s      <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

                     t      <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.

<?><?><?><?> (NOTE)
       <?><?> <?><?><?> <?><?><?><?> (<?><?><?><?><?> <?>.<?>)<?> dgmap
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> gmap(1)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       (<?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?>).
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> "cmplt"
       <?> "wcmplt" <?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> dgpart <?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?> <?><?><?>
       <?><?> <?><?><?><?> brol.grf <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       brol.map:

           $ mpirun -np 5 dgpart 7 brol.grf brol.map

       <?><?><?><?><?> dgpart <?><?><?> <?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> brol5-0.dgr <?><?> brol5-4.dgr <?><?> <?>
       <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> brol.map (<?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <<%p>> <?> <<%r>> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       dgscat(1) <?><?> <?><?><?><?><?><?>):

           $ mpirun -np 5 dgpart 7 brol%p-%r.dgr brol.map


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       dgtst(1), dgscat(1), amk_grf(1), acpl(1), gmap(1), gmtst(1).

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

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

                                 16 June 2026                         dgmap(1)