---
name: "ptscotch_dgtst"
section: "1"
platform: "linux"
package: "ptscotch"
version: "5.1.8a.dfsg-2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/ptscotch_dgtst"
---

# ptscotch\_dgtst(1)

test the consistency of Scotch source graphs in parallel

## NAME

**ptscotch\_dgtst** - test the consistency of Scotch source graphs in parallel

## SYNOPSIS

```
ptscotch_dgtst [options] [gfile] [lfile]
```

## DESCRIPTION

**The ptscotch\_dgtst program checks, in a parallel way, the consistency of a** **source graph, and outputs some statistics regarding edge weights,** **vertex weights, and vertex degrees in case of success.**

**It produces the very same results as the [gtst(1)](/gtst/1.md) program of the** **Scotch sequential distribution, but unlike this latter it can handle** **distributed graphs.**

**Source graph file** *gfile* **is either a centralized graph file, or a set** **of files representing fragments of a distributed graph. The** **resulting statistics are stored in file** *lfile***. When file names are** **not specified, data is read from standard input and written to** **standard output. Standard streams can also be explicitly** **represented by a dash '-'.**

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

**ptscotch\_dgtst bases on implementations of the MPI interface to spread work** **across the processing elements. It is therefore not likely to be run** **directly, but instead through some launcher command such as mpirun.**

## OPTIONS

- **-h**

  **Display some help.**

- **-r*pnum***

  **Set root process for centralized files (default is 0).**

- **-V**

  **Display program version and copyright.**

## EXAMPLE

**Run ptscotch\_dgtst on 5 processing elements to test the consistency of graph brol.grf**

```
      $ mpirun -np 5 ptscotch_dgtst brol.grf
```

**Run dgord on 5 processing elements to test the consistency of a** **distributed graph stored on graph fragment files brol5-0.grf to** **brol5-4.grf, and save the resulting ordering to file brol.ord (see** **[dgscat(1)](/dgscat/1.md) for an explanation of the '%p' and '%r' sequences in names** **of distributed graph fragments).**

```
      $ mpirun -np 5 ptscotch_dgtst brol%p-%r.grf brol.ord
```

## SEE ALSO

**[ptscotch\_dgscat(1)](/ptscotch_dgscat/1.md), ptscotch\_gtst(1), [ptscotch\_dgord(1)](/ptscotch_dgord/1.md).**

**PT-Scotch user's manual.**

## AUTHOR

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