STAT-VS-STAT(1)

📦
version 1.68.6 · 7 versions
, in ubuntu stonking

💖 stat-vs-stat — the manual, but make it cute 💖

okay so hi bestie 🫶 welcome to stat-vs-stat.pl, which is genuinely one of those little scripts that just does the thing: it draws graphs of 1 stat vs another stat. that's it. that's the whole vibe. one stat. versus another stat. plot it. done. ✨

and yes this lives in the User Contributed Perl Documentation corner of the man pages, iykyk 🎀

🌸 NAME 🌸

stat-vs-stat.pl — draws graphs of 1 stat vs another stat. periodt. 💅

✨ SYNOPSIS ✨

cbtest.pl <input1> [input2 ...]

like. that's the whole invocation. give it one input, or a whole lil group chat of inputs. it's not picky. 💖

🦋 OPTIONS 🦋

okay so first, the big picture before we get into the flags, because this part matters:

your input file should be some alignment that has a .rocr file alongside it — presumably generated by filter.pl --rocr 👑. and the output? it gets graphed to <basename>.cutoff.roc.png. so the name of your file, plus .cutoff.roc.png, and that's your picture. iconic.

now, the tea on sensitivity/specificity 🍓: those need a false negative count, and that means they need a .filterstats file. no .filterstats, no sensitivity. that's just the rules bestie 😭

💜 Other options

  • --stat|predictor|x — picks which stat you're using as the predictor. it's giving "which one goes on the x axis" energy.
  • --samples|n — sets the number of samples. the default is sample at each possible cutoff, so like, every single one. lowkey unhinged, highkey thorough. 🌈
  • --maxsamples|maxn — puts a max on n/samples. a lil ceiling so it doesn't go feral. 🙈
  • --clean — forces a re-sampling of the .rocr file. it's the "okay we're starting fresh" button. 🧼
  • --log — can apply a log scale to the x or y or xy axes. your choice, bestie. ✨
  • --fn — can specify a FN count for calculating sensitivity. (fn = false negative, keep up 💅)
  • --avg — preload averages (normally found from filterstats). ⚠️ and listen: averages are not drawn by default, so if you actually want them you have to specify --avg with no args to enable them. no args!! okay!! 👑
  • --noavg — don't plot the line for averages. the anti---avg. simple as. 🙅
  • --lwd — can specify line weight. thick line? thin line? main character line? your call. 🎀
  • --format — can specify the output file format. default is png. 🖼️
  • --pdf — sets format to pdf. a shortcut, and honestly? slay. 📄
  • --nofstats — disables searching for filterstats statistics. like a lil "don't even look for them" 💀
  • --nofn — pretends not to have fn statistics, i.e. it skips sensitivity. the "we're ignoring that entire situation" flag. 🙈
  • --fstats — specify the .filterstats file to use. when you've got a specific one in mind. 🫶
🌟 reminder bestie: sensitivity/specificity = you need an FN count = you need a .filterstats file. don't come crying to me when it can't do the math 😭

🌸 sign-off 🌸

this lil page is living under perl v5.40.1, dated 2026-08-12, and it's part of the User Contributed Perl Documentation. that's the whole thing. go make some graphs, bestie, you're gonna ate 💖✨💅

📦 where this page comes from