gtst(1)

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

💅 gtst — test the consistency of source graphs ✨

okay bestie, welcome to gtst(1), straight out of the Scotch user's manual 🎀 this is the girl whose whole job is checking that your source graph isn't lying to you.

✨ SYNOPSIS ✨

gtst [options] [gfile] [lfile]

🌸 DESCRIPTION 🌸

so gtst does one thing and does it iconically: it checks, in a sequential way, whether a Scotch source graph is actually consistent. and if the vibe check passes? it outputs some statistics about edge weights, vertex weights, and vertex degrees 🦋

ngl, it produces the very same results as the dgtst(1) program from the PT-Scotch parallel distribution — but unlike that one, it cannot handle distributed graphs. no cap. it's a centralized-graph kinda girlie.

the source graph file gfile can only be a centralized graph file. the resulting statistics get stored in lfile. and if you don't specify file names? data is read from standard input and written to standard output, as one does 💅 standard streams can also be explicitly represented by a dash '-'.

and here's the glow-up: when the proper libraries have been included at compile time, gtst 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')

💖 OPTIONS 💖

  • -h — display some help 🫶
  • -V — display program version and copyright 👑

⭐ EXAMPLE ⭐

test the consistency of graph brol.grf:

$ gtst brol.grf

periodt. that's the whole thing 🎀

🌈 SEE ALSO 🌈

also: the Scotch user's manual 📖 (iykyk)

👑 AUTHOR 👑

Francois Pellegrini <francois.pellegrini@labri.fr> — the main character who wrote all this 💜

fr fr, remember: gtst is sequential only, so don't come at it with a distributed graph expecting a miracle 🙈

and that's a wrap bestie 💖 this page was living its best life as part of the Scotch user's manual, version stamped 23 November 2019, filed under gtst(1). slay, go check those graphs ✨🦋🎀

📦 where this page comes from