MAPHIMBU(1)

💖 MAPHIMBU 💖 — the histogram builder bestie

okay so real quick, this is the manual page for maphimbu, a User Command ✨. It's a histogram builder for 1-d numerical and text data and honestly? she's iconic for it. 💅

---

🌸 SYNOPSIS 🌸

maphimbu [OPTION]... [FILE]

---

🦋 DESCRIPTION 🦋

So like, this program makes 1-d histograms out of numerical data OR text data, whatever you throw at it. Versatile queen. 👑

And ALSO — plot twist — you can use it to estimate the probability distribution function of a numerical variable. The whole lore is here if you wanna read up:

http://en.wikipedia.org/wiki/Probability_density_function

---

✨ OPTIONS ✨

okay bestie, here's the full menu, no skips, no cuts, all of it 🫶

• -x <int> — which column is your x-data. Default is 1. That's it, that's the vibe.
• -y <int> — which column is your y-data. Default is 2. Heads up tho: she only gets considered when you combine her with -m or -S. Otherwise she's just sitting there, pretty and unused. 🙈
• -d <float|int> — the delta size (aka the dx-resolution) for numerical data. CRUCIAL LORE: 2 is not the same as 2.0, bestie. With 2, the numbers get treated as integers. With 2.0, they're floats. Do not mix these up, I am begging. 😭
• -n — normalize the result. Two flavours:
  • A) non-numerical data: n(x) = counts(x)/sum_of_counts
  • B) numerical data: the normalized probability density func.

and the rule is P(-INF < x <INF) = Int_[-INF:INF] P(x)*dx = 1 ;

For the numerical integration, an open x-data interval is assumed. fyi. ✨

• -N — normalize data against the total sum of counts. Lowkey the same as option -n except with case A forced. 💅
• -U — normalize the result with the x-range mapped to unit. The x-values get mapped to the interval [0:1], respectively Int_[0:1] P(x)*dx = 1. Mutually exclusive with -n — pick a lane, you cannot have both. 🚫
• -S — compute sums and normalized sums of y-values. The normalization uses the total sum of ALL y-values.
• -m — compute the arithmetic average of the y-values inside the underlying x-bin. math girlie behavior 📐
• -a — compute accumulated sums of the result data column. Default is column 2, or column 3 if there's normalization happening. Also! the program mintegrate is needed in this case. Don't forget her. 🎀
• -s <int> — sort the output using the specified column. The header gets skipped in this case.
• -g <int> — sort the output numerically using the specified column. Header skipped here too, same deal.
• -r — do reverse sorting. Only hits different in combination with -g and -s. 🔄
• -C — center the histogram bins (shifts the x-axis by 0.5*dx). so symmetrical of her 🧚
• -X — treat the whole line as one string (a single data record). one line, one vibe.
• -H — print a data description header. 📋
• -V — print program version and exit. bye bestie 👋
• --version — output version AND copyright information. the full receipts.
• --help — display help. 🫶
• -h — display short help (options summary). the tl;dr version.

Note: this program is not intended for use in high order numerical computations. She's a vibe, not a supercomputer. Know her limits. 💀

---

🐛 REPORTING BUGS 🐛

Found a bug? Do NOT suffer in silence, bestie. Report bugs to:

<gnu@mirendom.net>

---

👑 COPYRIGHT 👑

Copyright © 2003-2007, 2009, 2011-2013 Dimitar Ivanov

License: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. 🫶

---

maphimbu 2.10.1 — July 2014 — and that's the whole page, periodt. 💖✨🎀 go build some histograms, you absolute main character. 🌈⭐💜