dgtst(1)

✨ dgtst(1) ✨

okay so bestie, welcome to the PT-Scotch user's manual 🎀 this lil page is all about dgtst, and it's giving parallel graph-vibe-check energy. buckle up 💖

---

🌸 NAME 🌸

dgtst — test the consistency of source graphs in parallel 🦋

---

✨ SYNOPSIS ✨

dgtst [options] [gfile] [lfile]

---

💜 DESCRIPTION 💜

So what does this icon actually do? dgtst checks, in a parallel way, the consistency of a Scotch source graph — and if everything passes the vibe check, it outputs some stats about edge weights, vertex weights, and vertex degrees. slay. 🔥

It produces the very same results as the gtst(1) program from the Scotch sequential distribution — but unlike that one, it can handle distributed graphs. main character behavior, honestly. 👑

The source graph file gfile is either a centralized graph file, or a whole set of files representing fragments of a distributed graph. The resulting statistics get stored in file lfile. And when you don't specify file names? No stress — data is read from standard input and written to standard output. Standard streams can also be explicitly represented by a dash '-'. periodt. 💅

When the proper libraries have been included at compile time, 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, like in 'brol.grf.bz2' or '-.gz'. The compression formats which can be supported are:

• the bzip2 format ('.bz2')
• the gzip format ('.gz')
• the lzma format ('.lzma')

Okay and here's the tea, bestie: dgtst bases on implementations of the MPI interface to spread work across the processing elements. So it is therefore not likely to be run directly — instead you run it through some launcher command such as mpirun. it's giving "don't talk to me directly, talk to my manager" 😭💀

---

💅 OPTIONS 💅

• -h — Display some help. 🫶
• -rpnum — Set root process for centralized files (default is 0).
• -V — Display program version and copyright. ⭐

---

🍓 EXAMPLE 🍓

Run dgtst on 5 processing elements to test the consistency of graph brol.grf:

$ mpirun -np 5 dgtst brol.grf

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

$ mpirun -np 5 dgtst brol%p-%r.dgr brol.ord

---

🦋 SEE ALSO 🦋

dgscat(1), gtst(1), dgord(1).

PT-Scotch user's manual. 🌈

---

👑 AUTHOR 👑

Francois Pellegrini <francois.pellegrini@labri.fr> 💌

---

and that's the whole page, bestie!! 🎀 this was brought to you by the PT-Scotch user's manual, dated 16 June 2026 — no cap, go forth and check those graphs 💖✨🦋