UNU-HISTAX(1)

πŸ“¦ version 1.11.0, in fedora 43, fedora 44

πŸ’– UNU-HISTAX(1) πŸ’–

okay bestie, pull up a chair, because this is unu-histax β€” a little User Command from the unu fam, and she is so much simpler than she looks. ✨


🌸 NAME 🌸

unu-histax β€” replace each scanline along an axis with its histogram πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

unu histax -a,--axis <axis> -b,--bin <bins> [-t,--type <type>]
[-min,--minimum <value>] [-max,--maximum <value>] [-blind8 <bool>]
[-i,--input <nin>] [-o,--output <nout>]

✨ DESCRIPTION ✨

So like, the whole vibe is in the name, fr fr: replace each scanline along an axis with its histogram. Every scanline? Gets turned into its own little histogram. That's it. That's the job. πŸ‘‘

  • it uses nrrdHistoAxis under the hood, iykyk

πŸŽ€ OPTIONS πŸŽ€

  • -a <axis>, --axis <axis> β€” the axis you're histogram-ing along. like, which direction are we slicing, bestie? (unsigned int)
  • -b <bins>, --bin <bins> β€” how many bins the histogram gets. the more bins, the more detail. (unsigned int)
  • -t <type>, --type <type> β€” the output type. default is "uint", no cap.
  • -min <value>, --minimum <value> β€” the value that gets mapped to zero. you can hand it a plain old regular number, OR, if you slap a "%" suffix on it, then this minimum is defined as the percentage of samples in the input that are lower. so "0%" means the lowest input value is what's used, and "1%" means the 1% of the lowest values all get mapped to zero. if you just… don't use this option at all, the default behavior is that the lowest input value is used. (string); default: "nan"
  • -max <value>, --maximum <value> β€” the value that gets mapped to the highest unsigned integral value. same deal as -min: give it a regular number, or give it a number with a "%" suffix and it means the percentage of samples in the input that are higher. "0%" means the highest input value is used β€” which is ALSO the default behavior, same as not using this option at all. (string); default: "nan"
  • -blind8 <bool> β€” whether to know the range of 8-bit data blindly. like, uchar is always [0,255] and signed char is [-128,127], so should we just assume that? (bool); default: "true"
  • -i <nin>, --input <nin> β€” the input nrrd, obviously πŸ₯°
  • -o <nout>, --output <nout> β€” the output nrrd. (string); default: "-" (which is stdout, so you can pipe her straight into the next thing, slay)

πŸ‘€ SEE ALSO πŸ‘€


ok important note bestie: -a/--axis and -b/--bin are the ones you genuinely cannot skip. they're not in brackets in the synopsis for a reason. everything else is optional. periodt. πŸ’€

Version vibes from August 2021, and this whole page lives under the UNU-HISTAX(1) header in the User Commands section of the manual. 🫢 that's a wrap, go histogram something iconic, mwah πŸ’–πŸŽ€βœ¨

πŸ“¦ where this page comes from