gmtst(1)

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

💖 NAME 💖

gmtst — the lil icon that computes statistics on mappings ✨

🦋 SYNOPSIS 🦋

gmtst [options] [gfile] [tfile] [mfile] [lfile]

🌸 DESCRIPTION 🌸

okay so bestie, gmtst is the program that computes statistics on a static mapping — and it does it in a sequential way. we're talking load imbalance ratio, edge dilation distribution, etc. the whole vibe check on your mapping. 🎀

and here's the tea: it yields the exact same results as the ones produced by the -vm option of the gmap(1) program. same output, different doorway, iykyk. 💅

now let's talk files:

  • the source graph file gfile can only be a centralized graph file. that's the rule, no exceptions, periodt.
  • file tfile is the target architecture — the one that gfile was mapped onto.
  • if your mapping file mfile was produced by gpart(1), then the target architecture file you hand to gmtst should describe a complete graph with the same number of vertices as the requested number of parts. how do you get one? for instance by means of the 'cmplt num' algorithmically-described architecture. slay. 🫶
  • the resulting statistics get stored in file lfile.

when file names are not specified, data is read from standard input and written to standard output. and yes, standard streams can also be explicitly represented by a dash '-'. iconic behaviour honestly. 🌈

compression moment: 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, such as 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. (the lil "help me help you" button 🙈)
  • -V — Display program version and copyright. (the receipts 📜)

🍓 EXAMPLES 🍓

1. Display statistics on mapping brol.map of graph brol.grf onto target architecture brol.tgt:

$ gmtst brol.grf brol.tgt brol.map

2. Display statistics on partitioning brol.map of graph brol.grf into num parts. note the use of the complete graph algorithmically-described architecture and of the shell pipe command to provide the complete target architecture description on the standard input of the gmtst command:

$ echo "cmplt num" | gmtst brol.grf - brol.map

💜 SEE ALSO 💜

gmap(1), gout(1), gtst(1).

Scotch user's manual.

👑 AUTHOR 👑

Francois Pellegrini <francois.pellegrini@labri.fr>

okay that's the whole page bestie, no cap 🫶 this was the Scotch user's manual edition of gmtst(1), dated 23 November 2019 — go forth and compute those statistics, you absolute main character 💖✨🎀

📦 where this page comes from