mord(1)

✨ NAME ✨

okay so bestie, welcome to mord β€” the Scotch user's manual girlie that computes sparse matrix orderings of meshes πŸ’… like that's literally her whole job and she ate.


πŸ¦‹ SYNOPSIS πŸ¦‹

mord [options] [mfile] [ofile] [lfile]

🌸 DESCRIPTION 🌸

so the mord program computes, in a sequential way, an ordering of a Scotch source mesh that's representing the pattern of some symmetric sparse matrix. periodt. πŸŽ€

ngl, only the nodes of the mesh are actually ordered, okay? The elements are just there providing connectivity info, such that every node is considered to be linked to all of the nodes which share at least an element with it. it's giving "we're all connected" energy fr fr πŸ¦‹

Source mesh file mfile can only be a centralized mesh file β€” no cap, that's the rule. The resulting ordering gets stored in file ofile. And eventual logging information (like the stuff that option -v produces) is sent to file lfile. When file names are not specified? data is read from standard input and written to standard output. Standard streams can also be explicitely represented by a dash '-'. iconic. ✨

🫢 lowkey important: when the proper libraries have been included at compile time, gord 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'), and the lzma format ('.lzma'). three formats, all slaying πŸ’œ

πŸ’– OPTIONS πŸ’–

  • -copt β€” Choose default ordering strategy according to one or several options among:
    • b β€” enforce load balance as much as possible.
    • q β€” privilege quality over speed (default).
    • s β€” privilege speed over quality.
    • t β€” enforce safety.
  • -h β€” Display some help. bestie said "I got you" 🫢
  • -mmfile β€” Save column block mapping data to file mfile. Mapping data specifies, for each node vertex, the index of the column block to which this node vertex belongs. πŸ—ΊοΈ
  • -ostrat β€” Use sequential mesh ordering strategy strat (see Scotch user's manual for more information).
  • -ttfile β€” Save partitioning tree data to file tfile. Partitioning tree data specifies, for each node vertex, the index of the first node vertex of the parent block of the block to which the node vertex belongs. Altogether with the mapping data provided in file mfile, it allows one to rebuild the separator tree of the nested dissection process. 🌳 like a whole family tree but for blocks, obsessed.
  • -V β€” Display program version and copyright. πŸ‘‘
  • -vverb β€” Set verbose mode to verb. It is a set of one of more characters which can be:
    • s β€” strategy information.
    • t β€” timing information.

πŸ”₯ EXAMPLE πŸ”₯

Reorder matrix mesh brol.msh and save the resulting ordering to file brol.ord using the default sequential mesh ordering strategy:

$ mord brol.msh brol.ord

look at her go 😭✨


πŸ‘€ SEE ALSO πŸ‘€

gmk_msh(1), gotst(1), mtst(1).

Scotch user's manual.


πŸŽ€ AUTHOR πŸŽ€

Francois Pellegrini <francois.pellegrini@labri.fr>


and that's the whole page bestie!! this one's from the Scotch user's manual, dated 23 November 2019 β€” go off, iconic documentation, we love to see it πŸ’œπŸ¦‹βœ¨

πŸ“¦ where this page comes from