gbbin.1 2.29 KB
Newer Older
1
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.44.1.
2
.TH GBBIN "1" "November 2015" "gbbin 5.6.7" "User Commands"
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63
.SH NAME
gbbin \- A program to bin data
.SH SYNOPSIS
.B gbbin
[\fIoptions\fR]
.SH DESCRIPTION
Compute binned statistics. Data are read from standard input as records
(X,Y1,Y2,...). Equipopulated bins are built with respect to the first field
X. Option \fB\-O\fR decide which statistics are printed for each bin. With options
\fB\-x\fR, \fB\-y\fR or \fB\-c\fR elements in different bins are split in different columns.
.SH OPTIONS
.TP
\fB\-n\fR
set the number of equipopulated bins (default 10)
.TP
\fB\-w\fR
min,max set manually the binning window. Ignored with \fB\-x\fR,\-y and \fB\-c\fR
.TP
\fB\-O\fR
set the output with a comma separated list of variables: xmean, xmin,
xmax, xstd, xmedian, ymean, yadev, ystd, yvar, yskew, ykurt, ymin,
ymax, ymedian, num (default xmean, ymean)
.TP
\fB\-c\fR#
the values in column # are split in different columns; # can be a comma
separated list of columns
.TP
\fB\-x\fR
equivalent to \fB\-c\fR 1
.TP
\fB\-y\fR
equivalent to \fB\-c\fR 2
.TP
\fB\-F\fR
specify the input fields separators (default " \et")
.TP
\fB\-v\fR
verbose mode
.SH EXAMPLES
.TP
gbbin \-n 20 < file
split the records (line) in 20 bins according to first
field. Print the average value of the bin entries for
each column. If 'file' has 3 columns, the output has
twenty rows and three columns.
.TP
gbbin \-O ymedian < file
bin the records with respect to the first value and
print the median value of the other columns in each bin
.TP
gbbin \-c 3 < file
the binned values of the third columns are printed on
separate columns. The output has ten columns.
.SH AUTHOR
Written by Giulio Bottazzi
.SH "REPORTING BUGS"
Report bugs to <gbutils@googlegroups.com>
.PP
.br
Package home page <http://cafim.sssup.it/~giulio/software/gbutils/index.html>
.SH COPYRIGHT
64
Copyright \(co 2001\-2015 Giulio Bottazzi
65 66 67 68 69 70 71 72
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
(version 2) as published by the Free Software Foundation;
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.