gbfun.1 2.35 KB
Newer Older
1
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.44.1.
2
.TH GBFUN "1" "November 2015" "gbfun 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
.SH NAME
gbfun \- Apply functions to table of data
.SH SYNOPSIS
.B gbfun
[\fIoptions\fR] \fI<function definition> \fR...
.SH DESCRIPTION
Compute arbitrary colum\-wise functions on data read from standard input.
Variable 'xi' stands for the i\-th column while 'x0' stands for the row
number, e.g. a function f(x1,x2) operates on the first and secod column.
With the option \fB\-t\fR the function is computed, in turn, on every column. In
this case f(x1,x2) stands for a function of the column itself and of the
following column (the index being a lead operator). In these cases 'x' is
equivalent to 'x1'. With \fB\-r\fR or \fB\-R\fR the function is recursevely computed
"columwise" on each row. In this case the variable 'x' identifies the
result of the previous evaluation. A lag operator can be specified with the
letter l, like in 'x1l2', which means the first column two steps before.
More functions can be specified and will be considered in turn.
.SH OPTIONS
.TP
\fB\-t\fR
compute on each column
.TP
\fB\-r\fR
set initial value and compute recursively
.TP
\fB\-R\fR
set initial value, compute recursively and print intermediary results
.TP
\fB\-v\fR
verbose mode
.TP
\fB\-F\fR
specify the input fields separators (default " \et")
.TP
\fB\-o\fR
set the output format (default '%12.6e')
.TP
\fB\-s\fR
set the output separation string (default ' ')
.TP
\fB\-h\fR
this help
.SH EXAMPLES
.TP
gbfun 'x0+log(x2)' file
print the log of the second column of 'file' adding
the progressive number of the row
.TP
gbfun \-r 0 'x+sqrt(x1)' file
print the sum of the square root of the elements
of the first column of 'file'
.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
62
Copyright \(co 2001\-2015 Giulio Bottazzi
63 64 65 66 67 68 69 70
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.