GBFUN(1)

📦 version 6.3, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GBFUN(1) 💖

okay bestie, welcome to gbfun, a User Commands legend (that's section 1 of the manual, iykyk) — she applies functions to a table of data and she does NOT miss. 🌸

✨ NAME ✨

gbfun — apply functions to a table of data. literally that's her whole job and she slays it 💅

🎀 SYNOPSIS 🎀

gbfun [options] <function definition> ...

🦋 DESCRIPTION 🦋

So here's the vibe: gbfun computes whatever functions you throw at it, on data it reads from standard input. Periodt.

By default she does the math column-wise, and she does it on each row of data separately. 🫶

The variable xi stands for the i-th column, while x0 stands for the row number. So like, a function f(x1,x2) operates on the first and second column. iconic.

But wait — with the option -t, the function gets computed, in turn, on every column. In that case f(x1,x2) stands for a function of the column itself and of the following column (the index being a lead operator, no cap). In these cases, x is equivalent to x1. 💫

With -r or -R, the function is recursively computed "columnwise" on each row. In this case the variable x identifies the result of the previous evaluation. it's giving ✨main character✨ energy, fr fr.

A lag operator can be specified with the letter l, like in x1l2, which means the first column two steps before. yes she can time travel, we stan. 🕰️

More functions can be specified, and they'll be considered in turn. the more the merrier bestie 🌈

💅 OPTIONS 💅

  • -T — compute the function row-wise, on each column separately. (the flippening 🔄)
  • -t — compute on each column
  • -r — set initial value and compute recursively
  • -R — set initial value, compute recursively and print intermediary results
  • -v — verbose mode (she's a talker 💬)
  • -F — specify the input fields separators (default " \t")
  • -o — set the output format (default '%12.6e')
  • -s — set the output separation string (default ' ')
  • -h — this help

🔥 EXAMPLES 🔥

okay so watch her work:

gbfun 'x0+log(x2)' < file

print the log of the second column of file, adding the progressive number of the row. obsessed. 😌

gbfun -T 'x0+log(x2)' < file

print the log of the second row of file, adding the progressive number of the column. we flipped it, we ate. 🍓

gbfun -r 0 'x+sqrt(x1)' < file

print the sum of the square root of the elements of the first column of file. math but make it cute ✨

👑 AUTHOR 👑

Written by Giulio Bottazzi

🐛 REPORTING BUGS 🐛

Found a bug? not the vibe. Report bugs to <gbutils@googlegroups.com> 💌

Package home page: <http://cafim.sssup.it/~giulio/software/gbutils/index.html>

Copyright © 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;

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.

bestie that's a LOT of caps, and for good reason — no promises, no guarantees, read the license fr fr 💀

and that's the whole page 🎀 this was gbfun 6.0.beta2, from October 2018 (yes she's vintage, she's an icon), stay hydrated, pipe something into her, bye 🫶💖

📦 where this page comes from