ISTATS(1)

📦 version 7.44.0, in nixpkgs unstable

✨ ISTATS(1) ✨

okay so real talk — this is istats, one of the BRL-CAD girlies, and she's here to do math on your little numbers. welcome bestie 💅

🌸 NAME 🌸

istats — compute basic statistics of a stream of short integers

like, it literally reads a whole stream of short ints and tells you the vibe. no cap.

🦋 SYNOPSIS 🦋

istats [-h] [file]

💖 DESCRIPTION 💖

okay so picture this: istats reads a stream of 16-bit signed short integers and computes basic statistics over the data, then writes a human-readable summary to standard output. that's it, that's the whole gig. ✨

input comes from the named file if you give one — otherwise it just reads from standard input. easy.

here's what she reports, and yes she's thorough:

  • the number of values (Num)
  • the minimum value (Min)
  • the maximum value (Max)
  • the sum (Sum)
  • the arithmetic mean (Mean)
  • and the sample standard deviation (SStdev)

she's the short-integer analogue of dstats(1) and ustats(1), which do the same thing for streams of doubles and unsigned chars respectively. so basically the whole friend group is out here computing stats, just for different types. iconic honestly 👑

🎀 OPTIONS 🎀

  • -h — print a usage message and exit. the -? form is also accepted, so if you're a -? kind of person, she's got you 🫶

⭐ EXAMPLES ⭐

Example 1. Summarize a file of signed-short sample data

istats samples.shorts

this reports the count, range, sum, mean, and sample standard deviation of the 16-bit signed integers stored in samples.shorts. ngl this is a super quick way to sanity check the dynamic range of intermediate signal-processing data — like a little vibe check for your numbers 🧚

the same data may instead be supplied on standard input, for example as the output of another short-integer filter:

imod -s 2 < samples.shorts | istats

piping it straight through, main character energy fr fr 🔥

🌈 SEE ALSO 🌈

brlcad(1), dstats(1), ustats(1), ihist(1), imod(1)

go say hi to the rest of the squad 💜

👑 AUTHOR 👑

BRL-CAD Team

This software is Copyright (c) 1989-2026 by the United States Government as represented by U.S. Army Research Laboratory.

🙈 BUG REPORTS 🙈

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org

bestie if something's acting up, don't just suffer in silence — email the devs, they genuinely want to know 🍓

okay that's the whole page, mwah 💋 — this one's from the BRL-CAD manual set, dated all the way from 1989 to 2026, so she's got history and she's still thriving 🌸🦋✨

📦 where this page comes from