pkstatogr(1)

💖 pkstatogr — the manual page, but make it make sense 💖

okay bestie, sit down, hydrate, because we're talking about pkstatogr(1) — that's the section 1 manual page for pkstatogr, and no cap, it's about to be your new fave little stats gremlin. 🫶

---

✨ NAME ✨

pkstatogr — a program to calculate basic statistics from a vector file. that's it, that's the job. 💅

---

🌸 SYNOPSIS 🌸

pkstatogr -i input [options]

like. give it an input, sprinkle some options, done. iconic.

---

🦋 DESCRIPTION 🦋

so pkstatogr calculates basic statistics on attributes of a vector file. literally what it says on the tin. 💖

examples of the basic statistics include:

• minimum
• maximum
• median
• mean
• standard deviation

and you can also get histograms — either in percentage or in absolute values, your choice, main character energy either way. ✨

the attribute you're actually interested in? you pick it with the option -n|--fname. 🎀

and here's the important bit, so listen up: values that are defined by the -nodata option, or that aren't within the limits set by the options -src_min and -src_max, are ignored for the statistics. gone. not invited to the party. 🚫

---

💅 OPTIONS 💅

• -i filename, --input filename — Input image file(s). If input contains multiple images, a multiband output is created. (yes babe, multiband. we're building a whole ensemble here. 🌈)
• -ln layer, --lname layer — Layer name(s) in sample (leave empty to select all). if you can't choose, honestly same — just leave it empty and take everything. 👑
• -n attribute, --fname attribute — Fields on which to calculate statistics. this is THE one. the field. the moment. 🎯
• -nodata value, --nodata value — Set nodata value(s). these get ignored in the stats, fr fr.
• -src_min value, --src_min value — Set minimum value for histogram. 📉
• -src_max value, --src_max value — Set maximum value for histogram. 📈
• -s, --size — Sample size (number of points). 💫
• -mm, --minmax — Calculate minimum and maximum value. two birds, one flag. 🐦
• -min, --min — Calculate minimum value. the smallest little guy. 🙈
• -max, --max — Calculate maximum value. the biggest. 🌟
• -mean, --mean — Calculate mean. average queen. 👑
• -median, --median — Calculate median. the middle child. 🎀
• -stdev, --stdev — Calculate standard deviation. how spread out are we feeling today. 🌊
• -hist, --hist — Calculate histogram. bars! 📊
• -nbin value, --nbin value — Number of bins to calculate histogram. how many lil buckets do you want. 🧺
• -rel, --relative — Use percentiles for histogram to calculate histogram. relative era. ✨
• -kde, --kde — Use Kernel density estimation when producing histogram. the Kernel class lives at http://pktools.nongnu.org/html/classKernel.html if you wanna peek 🫣 — and heads up: the standard deviation is estimated based on Silverman's rule of thumb. iykyk. 💜
• -v level, --verbose level — Verbose level. turn the yapping up or down, your call. 🗣️

---

🌈 EXAMPLE 🌈

report histogram of values in FIELDID (to standard output)

pkstatogr -i input.shp -f FIELDID -n 100

---

report min, max, mean and standard deviation of values in FIELDID (to standard output)

pkstatogr -i input.shp -f FIELDID -min -max -mean -stdev

---

and that's the whole page, bestie, you ate that. 💅✨

this was pkstatogr(1) — dated 01 January 2025. go forth and compute, and remember: not me being obsessed with your statistics. 🎀🦋💖