mtst(1)

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

💖 mtst — bestie's guide to testing source mesh consistency 💖

okay so you're in the Scotch user's manual, section 1, and the star of the show is mtst. she's here to vibe-check your meshes. let's get into it 🫶

✨ NAME ✨

mtst — test the consistency of source meshes 🧚

🌸 SYNOPSIS 🌸

mtst [options] [mfile] [lfile]

🦋 DESCRIPTION 🦋

so mtst is out here checking the consistency of a Scotch source mesh, and she does it in a sequential way — no parallelism, just her, one step at a time, being thorough 💅. and if everything passes? if it's all slay and no red flags? she outputs some statistics for you. like, real stats: stuff about edge weights, node and element vertex weights, and node and element vertex degrees. it's giving data. it's giving receipts 📊✨

now, about your source mesh file mfile — lowkey important — it can only be a centralized mesh file. that's the rule, no cap. and the resulting statistics get stored in file lfile. 🎀

and when you don't specify file names at all? no stress, bestie — data is read from standard input and written to standard output. standard streams can also be explicitly represented by a dash '-', if that's your thing 🙈

and here's the fun part: when the proper libraries have been included at compile time, mtst can directly handle compressed meshes, 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.msh.bz2' or '-.gz'. the compression formats which can be supported are:

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

compression queen behavior, honestly 🌈

💅 OPTIONS 💅

  • -h — Display some help. (she's helpful like that 🫶)
  • -V — Display program version and copyright. (the lore, the legacy ✨)

🍓 EXAMPLE 🍓

Test the consistency of mesh brol.msh:

$ mtst brol.msh

look at her go. iconic. no notes 💖

⭐ SEE ALSO ⭐

mcv(1), mord(1), gmk_msh(1).

Scotch user's manual.

👑 AUTHOR 👑

Francois Pellegrini <francois.pellegrini@labri.fr>

and that's the whole page, bestie!! written by the Scotch user's manual, dated 23 November 2019 — so yeah, she's been serving consistency checks since way back. go test those meshes, you got this 💜✨🎀

📦 where this page comes from