pfsstat(1)

✨ pfsstat — it's giving statistics, bestie ✨

okay so real talk: pfsstat is a lil command from the General Commands Manual, section 1, and it does exactly one thing and does it gorgeously. It's pfsstat, and it shows you frame / image statistics. That's it. That's the whole vibe. 💅

🌸 SYNOPSIS 🌸

pfsstat

no flags. no options. no arguments. she just exists. main character energy fr fr. 🎀

💖 DESCRIPTION 💖

So here's the tea ☕ — this command shows a short text statistic on each image in the pfs stream. One image at a time, stats on stats on stats. And in those statistics you're gonna find:

• File — name of the input file 📁
• Width, Height — image dimensions 📐
• Minimum — minimum luminance of an image(<span style="color:red">*</span>), given in linear units (relative luminance in cd/m^2) and logarithmic units
• Maximum — maximum luminance of an image(<span style="color:red">*</span>)
• Average — average luminance of an image(<span style="color:red">*</span>)
• Mean — mean luminance of an image(<span style="color:red">*</span>)

(<span style="color:red">*</span>) okay bestie, this footnote is important, don't skip it 🙈 — before min, max, average, median and dynamic range is computed, the following processing is performed on an image:

1. negative and zero values are replaced with the smallest positive value (to compute logarithms); 🧮
2. the image is low-pass filtered. 🌊

The low-pass filtering removes few very dark or very bright pixels that can significantly influence estimation of the dynamic range. The percentile, instead of a low-pass filter, is sometimes used for the same purpose. However, a low-pass filter is preferred to the percentile in pfstools since, taking into account the processing that is happening in the human visual system, low-frequency band filter is more plausible. 🧠✨

⚠️ Note: This command requires GNU Octave. like, actually requires it. no Octave, no stats, no slay. 😭

🌈 EXAMPLES 🌈

pfsin memorial.hdr | pfsstat

Show statistics for the memorial image. iconic pipeline behavior, lowkey the moment. 🫶

💀 BUGS 💀

Please report bugs and comments to Rafal Mantiuk <mantiuk@mpi-sb.mpg.de>. he's the one who needs to hear about it, not me, I'm just the messenger 🧚

and that's the whole page, bestie!! 🎀 written for the General Commands Manual, pfsstat(1), and there's no date stamped on this footer so we're just gonna say it's giving timeless. 💜 go forth and get those luminance numbers. periodt. 👑