GBHISTO(1)

🎀 GBHISTO 🎀

okay bestie, welcome to gbhisto — that's section 1 of the manual (User Commands, the cute little corner where the actual runnable programs live 💅). Buckle up, this one's a whole vibe.

---

✨ NAME ✨

gbhisto — Produce histogram from data 📊

---

🌸 SYNOPSIS 🌸

gbhisto [options]

that's it. that's the whole summoning ritual. no arguments, just vibes and options 🫶

---

🦋 DESCRIPTION 🦋

So what does it actually do? It computes a histogram, which is just counting how often stuff shows up. Two flavours, bestie:

• Discrete data — it counts the occurrences of each value, one by one.
• Continuous data — it bins the values onto a regular grid.

And where does the data come from? Standard input, always. It does not go hunting for files, it waits for you to pipe things in. Iconic behaviour, honestly.

Then it prints:

• for discrete data: the values and their occurrences;
• for binned data: the bin reference point and the relative statistics.

You get to pick the type of variable and which statistics you want with the -M option, and the binning grid itself can be linear, logarithmic, or geometric — pick your fighter.

About that reference point, because this part is lowkey important:

• for linear binning, the reference point is the algebraic midpoint;
• for log or geometric binning, it's the geometric midpoint.

And you can move it with the -S option. Set it to 0 to get the lower bound, or to 1 for the upper bound. Slay.

---

💖 OPTIONS 💖

• -n — number of equispaced bins where the histogram is computed (default 10) 🧺
• -w — min,max — set the binning window manually, with your own two hands ✋
• -M — set the type of output (default 0). Here's the menu, and yes you only pick one:
  • 0 — occurrences number (continuous binned variable)
  • 1 — relative frequency (continuous binned variable)
  • 2 — empirical density (continuous binned variable)
  • 3 — occurrences number (discrete variable)
  • 4 — relative frequency (discrete variable)
  • 5 — CDF (left cumulated probability; continuous binned variable)
  • 6 — inverse CDF (1-CDF; continuous binned variable)
• -B — set the type of binning (default 0):
  • 0 — linear
  • 1 — logarithmic
  • 2 — geometric
• -S — set the bin reference point (default 0.5) 📍
• -r — set the ratio for geometrical binning (default 1.618) — yes, the golden ratio, she's booked and busy ✨
• -t — print the histogram for each input column 🗂️
• -F — specify the input fields separators (default " \t") ✂️
• -v — verbose mode 🗣️

---

👑 AUTHOR 👑

Written by Giulio Bottazzi. a real one, fr fr.

---

😭 REPORTING BUGS 😭

Found a bug? Don't suffer in silence, bestie. Report bugs to <gbutils@googlegroups.com>.

Package home page: <http://cafim.sssup.it/~giulio/software/gbutils/index.html> — go peek, it's giving official 🫶

---

💜 COPYRIGHT 💜

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. (translation: it's free, it's generous, it is not promising you anything 💀)

---

and that's the whole page, no cap. this is gbhisto version 6.2, dated June 2021, and honestly? she ate. go make some histograms, bestie 🌈⭐💖