xtcombi(1)

NAME
xtcombi - combination

SYNOPSIS
xtcombi [-k list of attributes] -f list of attributes -n number [-p] -a name of a new attribute [-q] [-i input filename] [-o output filename] [-z] [-t] [-T directory of work file]

DESCRIPTION
For the lines having the same key value for the attribute specified by -k and for the set of values of the attribute specified by -f, it computes a set of all q-combinations with size q(="number" specified by -n).

PARAMETERS

-k list of attributes
    a list of attributes which determine the key in the computation. If -k is omitted, all lines are assumed to take the same key value.

-f list of attributes
    the attribute for which combinations are computed (more than one attribute cannot be specified).

-n number
    size of combination

-a name of a new attribute
    name of a new attribute

-i input filename
    Specify the input filename for this command. If a suffix of the filename is '.gz', the command automatically unzip it beforehand. When this parameter is omitted, standard input (usulally keyboard) is regarded as input file.

-o output filename
    Specify the output filename for this command. If a suffix of the filename is '.gz', the command automatically zip the output data. When this parameter is omitted, standard output (usulally display) is regarded as output file.

-T directory of work file
    Specify the directory name for temporal files used in this command.

OPTIONS

-p  permutation: compute permutation instead of combination

-q  the transaction of sequential: When this option specified with -k parameter, the command process the input data following the original sequence of the lines, instead of processing after sorting the field specified by -k parameter.

-z  compress the standard output by gz: When -o is omitted and this option is specified, the command output the result zipped.

-t  plain text: When this option is specified, the command treat the input and output data as plain text format.

EXAMPLE

 xtcombi -k customerID -f article -n2 -a article1,article2 -i dat.xt -o rsl.xt

 xtcombi -k customerID -f article -n3 -a article1,article2,article3 -p -i dat.xt -o rsl.xt

SEE ALSO

WEB PAGE
http://musashi.adm.osaka-sandai.ac.jp

BUG REPORT
musashi@adm.osaka-sandai.ac.jp

AUTHORS
Yukinobu Hamuro,Naoki Katoh,Katsutoshi Yada