NAME

       gmk_m2, gmk_m3 - create 2D and 3D grid source graphs

SYNOPSIS

       gmk_m2 [options] [-bbval] [-gcfile] [-t] [-y] dimX dimY [ofile]

       gmk_m3 [options] [-bbval] [-gcfile] [-t] [-y] dimX dimY dimZ [ofile]

DESCRIPTION

       The gmk_* programs create source graph files for some common, regular topologies.

       gmk_m2  creates  a 2D regular grid graph of dimX times dimY vertices, such that vertex (i,j) is connected
       to vertices (i,j-1), (i-1,j), (i+1,j) and (i,j+1), if they  exist.  If  the  -e  option  is  set,  it  is
       additionally connected to vertices (i-1,j-1), (i+1,j-1), (i-1,j+1) and (i+1,j+1), if they exist.

       gmk_m3  creates  a 3D regular grid graph of dimX times dimY times dimZ vertices, such that vertex (i,j,k)
       is connected to vertices (i,j,k-1), (i,j-1,k), (i-1,j,k), (i+1,j,k), (i,j+1,k)  and  (i,j,k+1),  if  they
       exist.

OPTIONS

       -bbval Set the base value of the graph to bval. Default base value is 0.

       -e     Build a 8-neighbor grid rather than a 4-neighbor one (for gmk_m2 only).

       -gcfile
              Output graph vertex coordinates (that is, geometry data to be used by gout) in file cfile.

       -h     Display some help.

       -t     Builds a torus rather than a grid.

       -V     Display program version and copyright.

       -y     Invert y coordinate in geometry.

EXAMPLE

       Create a 2D graph of 5x7 vertices, of base 1, along with its geometry:

           $ gmk_m2 5 7 -b1 -g/tmp/m5x7.xyz /tmp/m5x7.grf

SEE ALSO

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

       Scotch user's manual.

AUTHOR

       Francois Pellegrini <francois.pellegrini@labri.fr>

                                                  02 April 2021                                        gmk_m2(1)