gtst(1)

📦
version 7.0.17 · 2 versions
, in arch rolling, nixpkgs unstable, ubuntu stonking

💖 gtst(1) — the consistency-check bestie 💖

okay so bestie, welcome to gtst, straight out of the Scotch user's manual. it's a lil program living in section 1 of the manual (that's your classic user commands zone 🫶) and it's here to vibe-check your graphs. no cap.

✨ NAME ✨

gtst — test the consistency of source graphs 💅

🌸 SYNOPSIS 🌸

gtst [options] [gfile] [lfile]

🦋 DESCRIPTION 🦋

so gtst literally goes through a Scotch source graph sequentially (one lil step at a time, no multitasking) and checks that it's consistent. and when it passes?? it gives you the goods: statistics about edge weights, vertex weights, and vertex degrees. slay.

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. so if ur graph is spread out across a whole parallel setup, this is not the one, sorry bestie 😭.

the source graph file gfile can only be a centralized graph file. the stats it spits out go into lfile.

and when you don't name files at all? it's giving chill: data is read from standard input and written to standard output. you can also write a standard stream out explicitly with a dash '-' and it works exactly the same. iconic.

now here's the tea ☕ — when the proper libraries were included at compile time, gtst can handle compressed graphs directly, both as input and output. a stream counts 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') ⭐

💅 OPTIONS 💅

okay the options menu is short and sweet, we love efficiency:

  • -h — displays some help. ur little rescue text 🫶
  • -V — displays the program version and copyright. for when u need the receipts 🧾

🍓 EXAMPLE 🍓

say you wanna test the consistency of the graph brol.grf. boom:

$ gtst brol.grf

that's it. that's the whole move ✨

🔥 SEE ALSO 🔥

go bother these ones next, they're all in the family:

also: the Scotch user's manual. the og source of truth 👑

👑 AUTHOR 👑

Francois Pellegrini <francois.pellegrini@labri.fr> — the legend behind all this fr fr 🙌

16 June 2026 • gtst(1) • Scotch user's manual — that's the version and date bestie, sources and dates are eternal ✨💖 run gtst on ur graphs, stay consistent, and drink water 🫶🌸

📦 where this page comes from