1acpl(1)                      Scotch user's manual                      acpl(1)
2
3
4

NAME

6       acpl - compile a target architectures
7

SYNOPSIS

9       acpl [options] [itfile] [otfile]
10
11

DESCRIPTION

13       The  acpl  program compiles a decomposition-defined target architecture
14       file itfile of type 'deco 0' into a compiled decomposition-defined tar‐
15       get architecture of type 'deco 1', stored in file otfile.
16
17       Compiling a decomposition-defined architecture amounts to computing the
18       distance matrix of all possible subdomains, from the distance matrix of
19       all  terminal  subdomains  provided in the 'deco 0' format.  Since this
20       computation is internally performed every time a  'deco  0'  format  is
21       read,  and  is quadratic in time, pre-compiling the target architecture
22       by means of acpl can save some time when repeatedly computing  mappings
23       on a large decomposition-defined 'deco 0' target architecture.
24
25       When  the proper libraries have been included at compile time, acpl can
26       directly handle compressed files, both as input and output. A stream is
27       treated  as compressed whenever its name is postfixed with a compressed
28       file extension, such as in 'brol.tgt.bz2' or  '-.gz'.  The  compression
29       formats  which can be supported are the bzip2 format ('.bz2'), the gzip
30       format ('.gz'), and the lzma format ('.lzma').
31
32       Since decomposition-defined target architecture files have a size which
33       is  quadratic in the number of target vertices, because of the distance
34       matrix structures, using compressed files to store them may save a  lot
35       of space, especially for compiled target architecture files.
36

OPTIONS

38       -h     Display some help.
39
40       -V     Display program version and copyright.
41

EXAMPLE

43       Create a compiled cube-connected-cycle target architecture of dimension
44       4, and save it under the gzip(1) format  to  file  'ccc4c.tgt.gz'.  The
45       dash  '-' standard file name is used so that the 'deco 0' target archi‐
46       tecture description produced by amk_ccc(1) is read  from  the  standard
47       input, through the pipe.
48
49           $ amk_ccc 4 | acpl - ccc4c.tgt.gz
50
51

SEE ALSO

53       amk_grf(1), amk_ccc(1), atst(1), dgmap(1), gmap(1), gmtst(1).
54
55       Scotch user's manual.
56

AUTHOR

58       Francois Pellegrini <francois.pellegrini@labri.fr>
59
60
61
62                               23 November 2019                        acpl(1)
Impressum