xtbucket(1)

NAME
xtbucket - uniform partition of attribute range

SYNOPSIS
xtbucket [-k attribute list] -f attribute list -n number of partitions [-F output format{0|1|2}] [-c バケットタイプ{cnt|rng}] [-r] [-i input filename] [-o output filename] [-z] [-t] [-T directory of work file]

DESCRIPTION
 For those lines such that the value for the attribute specified by -k, the range of the numerical attribute specified by -f is partitioned into a fixed number of subintervals (also called buckets) so that the the number of lines falling into a bucket becomes as uniform as possible.

PARAMETERS

-k attribute list
    key attribute based on which a partition is performed (if omitted, all lines are assumed to take the same key value)

-f attribute list
    the attribute whose range is to be partitioned (mandatory: more than one attribute is not allowed)

-n number of partitions
    specify the number of partitions

-F output format
    specify the output format of bucket

-c バケットタイプ
    バケットの数値範囲の決め方を指定する

-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

-r  reverse order: determine the bucket index so that vaules in the bucket with smaller index are larger than those in the one with the larger index

-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

 xtbucket -f amount,quantity -n 5 -i dat.xt -o rsl.xt

 xtbucket -f amount,quantity -n 5 -F 1 -i dat.xt -o rsl.xt

 xtbucket -k customerID -f amount,quantity -n 5 -i dat.xt -o rsl.xt

SEE ALSO
xtagg(1), xtstatistics(1), xtshare(1)

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

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

AUTHORS
Yukinobu Hamuro,Naoki Katoh,Katsutoshi Yada