A standard-library Python script that reads a per-frame VMAF or PSNR log (libvmaf JSON/XML, or a plain CSV) and prints the mean, harmonic mean, median, 5th/10th-percentile (worst frames), and minimum side by side, then flags how far the average sits above the worst frames and whether a model/pooling method was named — so the single number you quote is the honest one. (ZIP containing 1 file(s) — scripts, datasets, provenance).
Download free PDF

The handbook · 7 volumes
Fora Soft Video Engineering Handbook
This metric-report sanity check script reads a per-frame VMAF or PSNR log and puts the mean, harmonic mean, percentiles and minimum side by side, so the number you quote reflects the worst frames too. Our seven-volume handbook covers the video stack end to end; Volume 1 explains quality metrics and compression in depth, Volume 3 covers QoE monitoring, and Volume 6 the AI models behind modern metrics. Written by Nikolay Sapunov, CEO at Fora Soft.
Need to know if your average VMAF score is hiding bad frames?
Send us a few libvmaf logs, and we will tell you which pooling to report and where your encodes break down on difficult scenes. 250+ video products shipped since 2005.