mtst(1)

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

💖 mtst(1) — Scotch user's manual 💖

okay bestie, gather round, because this is the little program that checks your mesh's vibe before you do anything else with it. it's mtst, from the Scotch user's manual, and she is here to make sure your source mesh is not a mess. 🦋

✨ NAME ✨

mtst — test the consistency of source meshes. yes girl, consistency check. it's giving "are you actually okay?" but for meshes. 💅

🌸 SYNOPSIS 🌸

mtst [options] [mfile] [lfile]

🎀 DESCRIPTION 🎀

so mtst checks — in a sequential way, no parallelism shenanigans here — whether a Scotch source mesh is consistent. and if it passes the vibe check? it outputs some statistics about:

  • edge weights
  • node and element vertex weights
  • node and element vertex degrees

the source mesh file, mfile, can only be a centralized mesh file. like, that's the only flavour she accepts, no cap. the resulting statistics get stored in lfile.

when you don't specify file names at all? data is read from standard input and written to standard output. and if you wanna be explicit about standard streams, you can literally just write a dash - for them. iconic. 🫶

here's the cute part: when the proper libraries were included at compile time, mtst can directly handle compressed meshes, both as input and output. a stream gets treated as compressed whenever its name is postfixed with a compressed file extension — think brol.msh.bz2 or -.gz. the compression formats that can be supported are:

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

⭐ OPTIONS ⭐

she has exactly two options and honestly? she doesn't need more. minimal queen behaviour. 👑

  • -h — display some help. short king of a flag, gets you unstuck. 🙈
  • -V — display program version and copyright. the receipts, basically. 💜

🌈 EXAMPLE 🌈

test the consistency of mesh brol.msh:

$ mtst brol.msh

literally that's it. one command. go off. 🔥

👑 SEE ALSO 👑

Scotch user's manual.

🧚 AUTHOR 🧚

Francois Pellegrini <francois.pellegrini@labri.fr>

and that's the whole page, bestie!! 🌸 this was the Scotch user's manual, page for mtst(1), dated 16 June 2026. go check those meshes, you've got this. mwah. 💖✨🎀🦋

📦 where this page comes from