dgtst(1)

📦 version 7.0.7, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing

💖 dgtst(1) — bestie edition 💖

okay so this is the dgtst page from the PT-Scotch user's manual, and honestly? it's giving "quietly powerful". let's get into it 🫶

✨ NAME ✨

dgtst — test the consistency of source graphs in parallel 🌈

✨ SYNOPSIS ✨

dgtst [options] [gfile] [lfile]

✨ DESCRIPTION ✨

so here's the vibe: the dgtst program checks, in a parallel way, the consistency of a Scotch source graph — and if everything passes the vibe check, it outputs some statistics about edge weights, vertex weights, and vertex degrees. 👑

It produces the very same results as the gtst(1) program of the Scotch sequential distribution, but unlike that one, it can handle distributed graphs. no cap. 💅

Source graph file gfile is either a centralized graph file, or a set of files representing fragments of a distributed graph. The resulting statistics get stored in file lfile. And when file names aren't specified? data is read from standard input and written to standard output. You can also explicitly represent standard streams with a dash '-'. iconic behavior honestly.

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 that can be supported are:

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

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, but instead through some launcher command such as mpirun. like, it needs its support system, and same.

✨ 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
not me noticing the example says dgord and then talks about saving an ordering… 👀 bestie, that's literally what the page says, so I'm passing it straight through to you, fr fr. no edits, no guesses.

✨ 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 one came from the PT-Scotch user's manual, dated 23 November 2019, and it's page dgtst(1) — go be a main character with your parallel graph consistency checks. periodt. 💅✨

📦 where this page comes from