histogram(1)

📦
version 3.3.1p2 · 7 versions
, in ubuntu stonking

💖 histogram(1) — the CMTK glow-up 💖

okay bestie, so this is <rainbow>histogram</rainbow> from The Computational Morphometry Toolkit (CMTK, the icon itself), and it's genuinely one of the most useful little gremlins in the whole toolbox. no cap.

✨ NAME ✨

histogram — Image histogram. that's it. that's the whole vibe. it looks at your image intensities and tells you how they're distributed. slay.

🦋 SYNOPSIS 🦋

histogram [options] image

🌸 DESCRIPTION 🌸

okay so what it does is: it makes a histogram of image intensities, and then it writes that histogram out as a tab-separated text file — straight to standard output. like, it just yeets it at stdout, so you decide where it lands. 💅

👑 OPTIONS 👑

🌈 Global Toolkit Options (these are shared by all CMTK tools)

these bad boys are the same for literally every CMTK tool, so once you know them you know them. main character energy for real.

  • --help — writes the list of basic command line options to standard output. the "help me bestie" button.
  • --help-all — writes the complete list of basic and advanced command line options to standard output. the deluxe help. it's giving thorough.
  • --wiki — writes the list of command line options to standard output but in MediaWiki markup. for when you're documenting things like a wiki girly. 📝
  • --man — writes man page source in 'nroff' markup to standard output. yes, it can generate its own kind of manual. it's self-aware, we love that.
  • --version — writes the toolkit version to standard output. iykyk.
  • --echo — writes the current command line to standard output. it repeats your own words back at you, respectfully.
  • --verbose-level <integer> — set the verbosity level. give it a number, it gets chattier (or quieter).
  • --verbose, -v — increments the verbosity level by 1. ⚠️ heads up: this one is deprecated, it's only still here for backward compatibility. so like, it works, but don't build your whole personality on it. 🙈
  • --threads <integer> — set the maximum number of parallel threads (for POSIX threads and OpenMP). it goes fast fr fr. 🔥

🎀 Main Options 🎀

this is the actual histogram part, the reason we're all here:

  • --nbins <none>, -n <none> — Number of histogram bins. the default is the number of grey levels. [Default: 0] — like, if you don't pick a number, it just figures it out from your image. so considerate. 💖
  • --normalize, -N — Normalize histogram to maximum 1.0. so the tallest bar is 1.0 and everything else is relative to it. cute and comparable.
  • --min <double> — User-defined minimum value. [Default: disabled] — you can hand it your own floor for the range.
  • --max <double> — User-defined maximum value. [Default: disabled] — same deal, but the ceiling.
  • --truncate, -t — Truncate histogram (do not enter values outside range into first/last bin). so without this, out-of-range values get shoved into the first or last bin; with -t, they just... don't. periodt.
  • --pad <boolean> — Image padding value. [Default: disabled]
  • --outfile <string>, -o <string> — File name pattern for histograms. [Default: NONE]
  • --mask <string>, -m <string> — File name for multi-valued mask file. [Default: NONE]
real talk: notice that <none> and <boolean> and <double> and <string> are exactly what the tool expects there — don't go swapping them around. the flags stay exactly as written, bestie. no improvising. 🫶

💜 AUTHORS 💜

Torsten Rohlfing, with contributions from Michael P. Hasak, Greg Jefferis, Calvin R. Maurer, Daniel B. Russakoff, and Yaroslav Halchenko. a whole squad. a whole friend group of very smart people. 👑

📜 LICENSE 📜

http://www.fsf.org/licensing/licenses/gpl.html

💀 BUGS 💀

Report bugs at http://nitrc.org/projects/cmtk/ — they wanna hear about it, genuinely. don't suffer in silence, that's not the vibe. 😭

🌟 ACKNOWLEDGMENTS 🌟

CMTK is developed with support from the NIAAA under Grant AA021697, National Consortium on Alcohol and Neurodevelopment in Adolescence (N-CANDA): Data Integration Component.

From April 2009 through September 2011, CMTK development and maintenance was supported by the NIBIB under Grant EB008381.

look at that funding history. iconic. 💅

and that's the whole page, bestie — go make some histograms 🌈

okay final sign-off energy: this page is living in CMTK 3.3.1p2, dated Jun 24 2026, and it's histogram(1) through and through. mwah 💖✨

📦 where this page comes from