.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH GBFUN "1" "October 2018" "gbfun 6.0.beta2" "User Commands"
.SH NAME
gbfun \- Apply functions to table of data
.SH SYNOPSIS
.B gbfun
[\fI\,options\/\fR] \fI\,<function definition> \/\fR...
.SH DESCRIPTION
Compute specified functions on data read from standard input. The default
is to perform the computation column\-wise, on each row of data separately.
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 the function row\-wise, on each column separately.
.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 \-T 'x0+log(x2)' < file
print the log of the second row of 'file'
adding the progressive number of the column
.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
Copyright \(co 2001\-2018 Giulio Bottazzi
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.