mcxdump - dump matrices, optionally map indices to labels

mcxdump -imx <fname> (matrix file) [-o <fname> (dumpf file ('-' for stdout))] [-tab <fname> (row/column tab (label) file)] [-tabc <fname> (column tab file)] [-tabr <fname> (row tab file)] [--lazy-tab (allow tab/domain mismatch)] [--transpose (work with the transpose)] [--no-values (omit values)] [--no-loops (omit loops)] [--force-loops (force loops)] [--dump-pairs (emit pairs per line)] [--dump-lines (emit rows per line)] [--dump-rlines (omit leading column node)] [--dump-tabc (dump tab file on column domain)] [--dump-tabr (dump tab file on row domain)] [-dump <fname> (alias for -o)] [-sep-value <str> (node/value separator)] [-sep-field <str> (field separator)] [-sep-lead <str> (lead separator)] [-h (list help)] [--apropos (list synopsis of all options)]

mcxdump reads a data file satisfying the mcl input format (refer to mcxio(5)). It outputs a line-based format. The --dump-pairs option yields a single matrix entry per line, identified by the respective column and row identifiers (either index or label) separated by the field separator. The --dump-lines and --dump-rlines result in the joining of all row entries on a single line, separated by the field separator. For both formats, the matrix value corresponding with a particular entry is by default output as well.

Input matrix.

Output stream.

Substitute column indices and row indices by labels from the tab file. Since the same tab file is used for both, this implies that the matrix domains are identical.

Substitute column indices by labels from the tab file.

Substitute row indices by labels from the tab file.

If used, the tab file domain(s) do not necessarily need to match the corresponding domain in the input matrix. Entries missing in the tab files will be replaced by a question mark.

Do not emit values.

Do not output entries for which the row index equals the column index, if present. Applies only to matrices for which column and row domains are equal.

For each column, force output of a row entry that matches the column index. Applies only to matrices for which column and row domains are equal.

Output a single pair of column-identifier and row-identifier per line, optionally followed by the value of the corresponding matrix entry. All fields are separated by the field separator.

For each matrix column, the corresponding row is output on a single line, with row identifiers separated by the field separator and values attached to the row identifier by the node/value separator. In this format, the column identifier is output as the leading field.

As the option above, except that the column identifier is not output.

This will only infer the domains from the input matrix. It assumes the input tab file envelopes the matrix column domain, and it outputs a new tab file restricted to that domain.

This will only infer the domains from the input matrix. It assumes the input tab file envelopes the matrix row domain, and it outputs a new tab file restricted to that domain.

Set the node/value separator for line based row ensemble output.

Set the field separator for different row indices in a given column.

Set the lead separator. In the --dump-lines format it separates the leading column index from the following ensembl of row indices. It can be useful to make this different from the field separator. One can for example grep for columns that have more than one entry in a matrix mapping nodes to clusters. This will find nodes in overlap.

Print help, same as --apropos.

List a one-line synopsis for all options.

Stijn van Dongen.

mcxload(1), mcl(1), mclfaq(7), and mclfamily(7) for an overview of all the documentation and the utilities in the mcl family.