amk_grf(1)

🎀 amk_grf 🎀 — create target architecture from source graph

Okay so, bestie, this is the manual page for amk_grf, the Scotch tool that makes a target architecture. It's giving topology builder energy ✨

🌸 SYNOPSIS 🌸

amk_grf [options] [gfile] [tfile]

💖 DESCRIPTION 💖

Okay, the main vibe: the amk_grf program builds a decomposition-defined target architecture called tfile from a source graph called gfile. 🦋

Target architectures define the topology of the target graphs that the static mapping programs gmap(1) and dgmap(1) use. Some of them are algorithmically-defined, which is perfect for common, regular topologies, and others are decomposition-defined, like the ones amk_grf makes. 🧚

Now the compression part is so cute 🫶 When the proper libraries were included at compile time, amk_grf can handle compressed files directly, both for input and output. A stream counts as compressed whenever its name ends with a compressed file extension, like brol.tgt.bz2 or -.gz. The formats it can support are bzip2 (.bz2), gzip (.gz), and lzma (.lzma). 💅

Also, decomposition-defined target architecture files get quadratically huge as the number of target vertices grows, because they carry a distance matrix structure. So compressing them can save a lot of space. Literally a lifesaver 😭🔥

✨ OPTIONS ✨

• -bstrat — Okay, this one applies bipartitioning strategy strat to compute the recursive bipartition of the whole source graph into smaller target subdomains. 👑
• -h — Shows some help. 🙈
• -llfile — Only keeps vertices whose indices belong to the space-separated list stored in lfile. This lets you make target architectures that can even be disjoint subsets of a bigger target architecture, modeled as a graph. It's giving main character energy 💜
• -V — Displays the program version and copyright. 🌈

🦋 EXAMPLE 🦋

Say you want a decomposition-defined target architecture from a 2D regular grid source graph of dimension 3 times 5, saved as a compiled target architecture in gzip(1) format to the file m3x5.tgt.gz. Here's how you slay it:

$ gmk_m2 3 5 | amk_grf | acpl - m3x5.tgt.gz

Ngl, in this exact case it's way better to just use the mesh2D algorithmically-defined target architecture directly 💀

$ echo "mesh2D 3 5" > m3x5.tgt

🌈 SEE ALSO 🌈

acpl(1), amk_ccc(1), atst(1), dgmap(1), gmap(1), gmtst(1).

Scotch user's manual 📖

👑 AUTHOR 👑

Francois Pellegrini <francois.pellegrini@labri.fr> 🎀

Bye bestie, that's the whole tea, and it's signed off by version 02 September 2020 💖🦋