---
name: "gmk_hy-long"
section: "1"
platform: "linux"
package: "scotch"
version: "7.0.7-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gmk_hy"
---

# gmk\_hy-long(1)

create source graphs

Part of [gmk\_hy(1)](/gmk_hy/1.md).

## NAME

**gmk\_hy, gmk\_m2, gmk\_m3, gmk\_ub2** - create source graphs

## SYNOPSIS

```
gmk_hy [options] dim [ofile]
gmk_m2 [options] [-gcfile] dimX dimY [ofile]
gmk_m3 [options] [-gcfile] dimX dimY dimZ [ofile]
gmk_ub2 [options] dim
```

## DESCRIPTION

**The gmk\_\* programs create source graph files for some common,** **regular topologies.**

**gmk\_hy creates a hypercube of dimension** *dim***.**

**gmk\_m2 creates a 2D regular grid of dimensions** *dimX* **and** *dimY***.**

**gmk\_m3 creates a 3D regular grid of dimensions** *dimX***,** *dimY* **and** *dimZ***.**

**gmk\_ub2 creates an unoriented de Bruijn graph of dimension** *dim***.**

## OPTIONS

- **-b base**

  **For gmk\_m2 and gmk\_m3 only. Output graphs with base** **value set to base. Default value is 0.**

- **-e**

  **For gmk\_m2 only. Build a 8-neighbor grid rather than a** **4-neighbor grid.**

- **-g*cfile***

  **For gmk\_m2 and gmk\_m3 only. Output graph vertex** **coordinates (that is, geometry data to be used by** **[gout(1)](/gout/1.md)) in file** *cfile***.**

- **-h**

  **Display some help.**

- **-t**

  **For gmk\_m2 and gmk\_m3 only. Create torus graphs, that** **is, graphs such that there exist loop edges between** **vertices of rank 0 and (***dim***-1) in every dimension.**

- **-V**

  **Display program version and copyright.**

## EXAMPLE

**Create a 5x7 grid along with its geometry:**

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

## SEE ALSO

**[gbase(1)](/gbase/1.md), [gmk\_msh(1)](/gmk_msh/1.md), [gtst(1)](/gtst/1.md), [gmap(1)](/gmap/1.md), [gord(1)](/gord/1.md), [gout(1)](/gout/1.md), [amk\_grf(1)](/amk_grf/1.md).**

**Scotch user's manual.**

## AUTHOR

**Francois Pellegrini \<francois.pellegrini@labri.fr\>**