GBHISTO2D(1)

💖 GBHISTO2D 💖

okay bestie, gather round, because this is gbhisto2d from the User Commands manual, and she is so much more fun than she looks. no cap.

---

✨ NAME ✨

gbhisto2d — Produce 2D histogram from data. that's it, that's the girl. she takes your data and she makes you a histogram, in two dimensions, because one dimension is for cowards 🦋

---

🌸 SYNOPSIS 🌸

gbhisto2d [options]

that's literally it. no files to name, no arguments to fight with. she just wants options, and she wants your data on standard input. periodt.

---

👑 DESCRIPTION 👑

okay so here's the vibe: this is a 2D histogram on a regular grid. Data are read from standard input as couples (X,Y). yes, couples. they come in pairs. it's giving romance, honestly 💅

If data are treated as continuous, equispaced bins are built, and their center coordinates together with the required statistics are printed. so she builds the bins for you, evenly spaced, and then hands you back the bin centers plus whatever stats you asked for. iconic.

For discrete variables, bins are built directly from the given variables. no middleman, no equispacing, the variables are the bins. we love a direct communicator.

Transition matrices (option -M 5 and -M 8) have final states across the rows. write that down. put it on a sticky note. it matters, iykyk.

And in case of continuous variables, it is also possible to consider rectangular matrices. so not everything has to be a perfect square, she's flexible 🎀

---

🧚 Options : 🧚

• -M — choose the statistics to print for each bin. default is 0. and here's the whole menu, bestie, take your time:
  • 0 — occurrences number for continuous binned variables (*)
  • 1 — relative frequency for continuous binned variables (*)
  • 2 — empirical density for continuous binned variables (*)
  • 3 — occurrences number for discrete symmetric variables (bins{X}=bins{Y})
  • 4 — relative frequency for discrete symmetric variables (bins{X}=bins{Y})
  • 5 — transition matrix (X=>Y) for discrete symmetric variables (bins{X}=bins{Y})
  • 6 — occurrences number for discrete asymmetric variables
  • 7 — relative frequency for discrete asymmetric variables
  • 8 — transition matrix (X=>Y) for continuous binned variables (*)

lowkey note the asterisks (*), because they come back in a sec 👀

• -n — number of equispaced bins where the histogram is computed. for the output marked with (*), use comma , to specify different values for x and y coordinates. default is 10. so yes, -n 5,20 is a whole thing and she'll respect it.
• -v — verbose mode. she'll narrate. some of us need that.
• -F — specify the input fields separators (default " \t"). that's a space and a tab, exactly as written. no notes.
• -h — this help. your little emergency exit, we stan 🫶

---

🌈 EXAMPLES 🌈

1. compute a 2D histrogram using 20x20 bins:

gbhisto2d -n 20 < file

2. compute transition matrix on equispaced bins for continuous variables:

gbhisto2d -M 8 -n 4 < file

(and yes, "histrogram" is spelled like that up there and i am NOT fixing it, that's her spelling, we respect the original 💀)

---

💜 AUTHOR 💜

Written by Giulio Bottazzi. the mastermind. the moment. the main character. 🎀

---

😭 REPORTING BUGS 😭

found something cursed? Report bugs to <gbutils@googlegroups.com> — they want to hear from you, fr fr.

Package home page: <http://cafim.sssup.it/~giulio/software/gbutils/index.html> — go snoop, it's fine.

---

⭐ 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.

bestie that last paragraph is not a vibe, it's a legal thing. she is genuinely, sincerely promising you nothing. no warranty. none. zero. she's still your girl though 💖

---

🦋 SEE ALSO 🦋

sadly, there's no SEE ALSO section in this page. she's an only child. no siblings listed. no cross-references. just her, standing there, doing histograms. and honestly? she ate. 🔥

---

that's the whole page!! you now know gbhisto2d better than you know some of your relatives. this was gbhisto2d version 6.1, from March 2019, lovingly documented in the GBHISTO2D(1) manual page. go make a histogram, bestie, you deserve it ✨💅🌈