mcx(1) [debian man page]
mcx(1) USER COMMANDS mcx(1) NAME mcx - perform various computations on graphs and matrices SYNOPSIS mcx <mode> [mode-options] [mode-files] DESCRIPTION mcx implements a variety of computations on graphs and matrices. The first argument to mcx should be a mode, which is a string establishing the type of computation to invoke. Each mode mode is described in the mcxmode manual page. The currently available modes are convert, diame- ter, clcf, q and ctty. The convert mode is thus described in the mcxconvert manual page. Invoking mcx without arguments causes it to print out a list of available modes with a short description of the type of command line expected by that mode. Invoking mcx with just a mode will print out a longer listing of options available for that particular mode. Modes that are able to func- tion normally without arguments can be invoked by adding the --nop argument. Several options are shared between all mcx modes. Note that these options are specified after the mode. See OPTIONS. The --version causes mcx to print out version and license information. Issuing mcx help mode will cause mcx to look for a manual page describing mode and display it if found. This requires that the MANPATH envi- ronment variable contains the directory in which the MCL-edge manual pages were installed. This will usually be PREFIX/share, where PREFIX is the path with which the software was configured. OPTIONS These are options that pertain to all modes. They should be specified after the mode argument. -h (synopsis) --help (synopsis) List available options. --nop (no-op) Not an option. This option has no effect then to increment the argument count. This can be useful for mcx modes which are able to function without any options. Such a mode typically reads from STDIN, writes to STDOUT, and uses default settings. However, simply specifying a mode without options leads mcx to output a list of available options for that mode. This can be prevented by using the --nop option. -set (key=val) Sets the key key to value val in the environment. Some modes allow adjustment of settings in this manner. -progress <num> (progress interval size) Defines the interval that defines the progress frequency. --debug (turn on debugging) Turn debugging on. --version (show version) Show version. AUTHOR Stijn van Dongen. SEE ALSO mclfamily(7) for an overview of all the documentation and the utilities in the mcl family. mcx 12-068 8 Mar 2012 mcx(1)
Check Out this Related Man Page
mcxmap(1) USER COMMANDS mcxmap(1) NAME mcxmap - permute or remap the indices of graphs and matrices. SYNOPSIS mcxmap -imx fname (input) [-o fname (output)] [-make-map (output map file name)] [-make-mapc (output map file name)] [-make-mapr (output map file name)] [-cmul a (coefficient)] [-cshift b (translate)] [-rmul c (coefficient)] [-rshift d (translate)] [-mul e (coefficient)] [-shift f (translate)] [-map fname (row/col map file)] [-rmap fname (row map file)] [-cmap fname (column map file)] [-mapi fname (row/col map file (use inverse))] [-rmapi fname (row map file (use inverse))] [-cmapi fname (column map file (use inverse))] [-tab fname (read (and map) tab file)] DESCRIPTION This utility relabels graphs or matrices. Its main use is in applying a map file to a given matrix or graph. A map file contains a so called map matrix in mcl format that has some special properties (given further below). The functionality of mcxmap can also be provided by mcx, as a mapped matrix (i.e. the result of applying a map matrix to another matrix) is simply the usual matrix product of a matrix and a map matrix. However, mcx will construct a new matrix and leave the original matrix to be mapped alone. When dealing with huge matrices, consid- erable gains in efficiency memory-wise and time-wise can be achieved by doing the mapping in-place. This is what mcxmap does. In the future, its functionality may be embedded in mcx with new mcx operators. The special properties of a map matrix are o The column domain and row domain are of the same cardinality. o Each column has exactly one entry. o Each row domain index occurs in exactly one column. These properties imply that the matrix can be used as a map from the column domain onto the row domain. An example map matrix is found in the EXAMPLES Section. OPTIONS -o fname (output file) Output file. -imx fname (input file) Input file. -map fname (row/col map file)) -rmap fname (row map file) -cmap fname (column map file) -mapi fname (row/col map file (use inverse)) -rmapi fname (row map fil (use inverse)) -cmapi fname (column map fil (use inverse)) Different ways to specify map files. -make-map (output map file name) -make-mapc (output map file name) -make-mapr (output map file name) Generate a map that maps the specified domain onto the appropriate canonical domain and write the map matrix to file. -cmul a (coefficient) -cshift b (translate) These options have affect if neither a column map file nor column canonification is specified. If any of the first two options is used, column indices i are mapped to a*i+b. -rmul c (coefficient) -rshift d (translate) These options have affect if neither a row map file nor row canonification is specified. If any of the first two options is used, indices i are mapped to c*i+d. -mul e (coefficient) -shift f (translate) If a map file is specified for a given domain, neither a map file nor canonification is specified. If any of the first two options is used, the indices i will be mapped to e*i+f. -tab fname (read (and map) tab file) This option requires the -map option. mcxmap will output the mapped tab definition. EXAMPLES The matrix below has two canonical domains which are identical. It denotes a map of the canonical domain onto itself, in which node 0 is relabeled to 8, node 1 is relabeled to 5, et cetera. (mclheader mcltype matrix dimensions 12x12 ) (mclmatrix begin 0 8 $ 1 5 $ 2 3 $ 3 2 $ 4 4 $ 5 6 $ 6 7 $ 7 9 $ 8 1 $ 9 10 $ 10 11 $ 11 0 $ ) AUTHOR Stijn van Dongen. SEE ALSO mcxio(5), mcx(1), mcxsubs(1), and mclfamily(7) for an overview of all the documentation and the utilities in the mcl family. mcxmap 12-068 8 Mar 2012 mcxmap(1)