SUBPIX(1)

🎀 NAME 🎀

Hiii okay so this is subpix, bestie — and the official one-line description it ships with is, and I quote, AME. That's it. That's the whole thing. No cap, that's what the page says. Mysterious main character energy fr fr. 🙈

Also for the record, this page lives in the User Commands part of the manual (yes, the section 1 "you run this in a terminal" corner of the world), and the title up top is just SUBPIX(1). Slay.

---

🦋 SYNOPSIS 🦋

subpix [-vn] file.fts x y value...

Periodt. That's the whole shape of it. 💅

---

💖 DESCRIPTION 💖

So what does it actually do? Bestie, it subtracts from a pixel of a FITS or IRAF image file. That's the vibe. ✨

You point it at your image — file.fts in the synopsis, but the point is it's a FITS or IRAF image — and then you hand it an x and a y to say which pixel you're targeting, and a value (the ... at the end is doing a lot of heavy lifting there, iykyk) to subtract. Pixel goes in, math happens, pixel comes back out changed. 🧚

Now — the flags. There's two and they're both little legends:

• -n — write a new file instead of touching the original. Like, obviously this is the one you want, bestie. 🙈
• -v — verbose. It tells you what it's doing while it does it. Narrator mode. 💜

⚠️ Okay important thing, lowkey highkey: if you don't pass -n, it overwrites your file. Not "asks nicely". Not "makes a copy first". It overwrites. So unless you truly enjoy chaos and crying over lost data, use -n and keep your original. Protect the original at all costs. 😭

---

🌸 THE SIGN-OFF 🌸

This absolutely gorgeous piece of documentation is from source EB_SOURCE and it's dated February 2026. Stan a page that knows its own lore. 👑

Go subtract some pixels, bestie. 🫶🌈💖