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

# amk\_grf-int32(1)

create target architecture from source graph

Part of [amk\_grf(1)](/amk_grf/1.md).

## NAME

**amk\_grf** - create target architecture from source graph

## SYNOPSIS

```
amk_grf [options] [gfile] [tfile]
```

## DESCRIPTION

**The amk\_grf program builds a decomposition-defined target** **architecture** *tfile* **from a source graph** *gfile***.**

**Target architectures define the topology of the target graphs used** **by static mapping programs [gmap(1)](/gmap/1.md) and [dgmap(1)](/dgmap/1.md). Target** **architectures can be either algorithmically-defined, for common,** **regular topologies, or decomposition-defined, such as the ones** **produced by amk\_grf.**

**When the proper libraries have been included at compile time, amk\_grf** **can directly handle compressed files, 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.tgt.bz2' or '-.gz'. The** **compression formats which can be supported are the bzip2 format** **('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma').**

**Since decomposition-defined target architecture files have a size** **which is quadratic in the number of target vertices, because of the** **presence of a distance matrix structure, using compressed files to** **store them may save a lot of space.**

## OPTIONS

- **-b*strat***

  **Apply bipartitioning strategy** *strat* **to compute the** **recursive bipartition of the whole source graph into** **smaller target subdomains.**

- **-h**

  **Display some help.**

- **-l*lfile***

  **Only keep vertices the indices of which belong to the** **space-separated list stored in** *lfile***. This allows one** **to create target architectures which can even be** **disjoint subsets of a larger target architecture,** **modeled as a graph.**

- **-V**

  **Display program version and copyright.**

## EXAMPLE

**Create a decomposition-defined target architecture from a 2D regular** **grid source graph of dimension 3 times 5, and save it, as a compiled** **target architecture, under the [gzip(1)](/gzip/1.md) format, to file 'm3x5.tgt.gz'.**

```
    $ gmk_m2 3 5 | amk_grf | acpl - m3x5.tgt.gz
```

**Note that, in this precise case, it would be much preferable to use** **directly the 'mesh2D' algorithmically-defined target architecture.**

```
    $ echo "mesh2D 3 5" > m3x5.tgt
```

## SEE ALSO

**[acpl(1)](/acpl/1.md), [amk\_ccc(1)](/amk_ccc/1.md), [atst(1)](/atst/1.md), [dgmap(1)](/dgmap/1.md), [gmap(1)](/gmap/1.md), [gmtst(1)](/gmtst/1.md).**

**Scotch user's manual.**

## AUTHOR

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