acpl(1)

πŸ’– acpl πŸ’–

bestie, this is the manual page for acpl, and it's giving main character energy ✨


✨ NAME ✨

acpl - compile a target architectures 🌸

πŸ“œ SYNOPSIS πŸ“œ

acpl [options] [itfile] [otfile]

πŸ’­ DESCRIPTION πŸ’­

Okay so acpl takes a decomposition-defined target architecture file, itfile, that's in the 'deco 0' type and compiles it into a compiled decomposition-defined target architecture of type 'deco 1', which gets stored in the file otfile πŸ’…

Compiling a decomposition-defined architecture is basically computing the distance matrix of all possible subdomains, starting from the distance matrix of all terminal subdomains that you hand over in the 'deco 0' format. 🧚 Here's the tea: that computation happens every single time a 'deco 0' format gets read, and it's quadratic in time. So pre-compiling with acpl can save some time if you keep computing mappings on a big decomposition-defined 'deco 0' target architecture 😭

If the proper libraries were included at compile time, acpl can handle compressed files directly, for both input and output 🌈 A stream counts as compressed whenever its name ends in a compressed file extension, like 'brol.tgt.bz2' or '-.gz'. The formats it supports are bzip2 ('.bz2'), gzip ('.gz'), and lzma ('.lzma') πŸ¦‹

Decomposition-defined target architecture files are quadratic in size with respect to the number of target vertices, thanks to those distance matrix structures πŸ™ƒ So using compressed files to store them may save a lot of space, especially for the compiled target architecture files πŸ’œ

πŸŽ€ OPTIONS πŸŽ€

  • -h β€” the help menu, bestie. It displays some help 🫢
  • -V β€” shows the program version and copyright πŸ‘‘

πŸ“ EXAMPLE πŸ“

Let's make a compiled cube-connected-cycle target architecture of dimension 4 and save it in gzip(1) format to the file 'ccc4c.tgt.gz' 🧚 The dash '-' standard file name lets the 'deco 0' target architecture description from amk_ccc(1) get read from standard input, through the pipe. It's so smooth 🫧

$ amk_ccc 4 | acpl - ccc4c.tgt.gz

πŸ”— SEE ALSO πŸ”—

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

Scotch user's manual.

πŸ‘‘ AUTHOR πŸ‘‘

Francois Pellegrini <francois.pellegrini@labri.fr> πŸ’–


That's the tea, bestie! 🌈 This page is from the Scotch user's manual, dated 23 November 2019. Stay iconic, and I'll see you in the next manpage πŸ’…βœ¨

πŸ“¦ where this page comes from