susa2(1)

✨ susa2 — bestie edition ✨

okay so. sit down, grab a strawberry, because we're about to find stars 🌟

---

🌸 NAME 🌸

susa2 — Find USNO-SA2.0 Catalog stars in a square on the sky 💫

---

🎀 SYNOPSIS 🎀

susac [options] [-b or -j] ra dec

(yes bestie, the synopsis literally says susac. that's not a typo on my part, that's what's in there, and I am NOT touching it 💅)

---

🦋 DESCRIPTION 🦋

so suac — and again, that's what it says, I'm just the messenger 🫶 — goes and finds all of the U.S. Naval Observatory SA2.0 Catalog objects chilling in a region of the sky you point it at, and then it lists their sky positions and magnitudes in order of brightness. main character behavior, honestly.

Where does all that go? Standard out, naturally. ✨ Unless you set the -w flag, in which case it gets written out to objectname.uac or search.uac instead. fyi it's a link to scat.

---

💖 OPTIONS 💖

• -a — list single closest catalog source. just the one. the closest one. no drama, no crowd. 👑
• -b <RA> <Dec> — Output B1950 (FK4) coordinates around this center. old-school coords, vintage vibes 🕰️
• -d — Sort by distance from center instead of flux. not by brightness, by how close to your center they are 📍
• -h — Print heading, else do not. yes heading, or no heading. pick one bestie 🎀
• -j <RA> <Dec> — Output J2000 (FK5) coordinates around this center. the modern era, we love to see it ✨
• -m [<bright magnitude>] <faint magnitude> — Limiting catalog magnitude(s) (default none, bright -2 if only faint is given). so you can set both ends of the brightness range, or just hand over the faint one and the bright one quietly defaults to -2 🌈
• -n <num> — Number of brightest stars to print. how many of the it-girls are we showing? 💅
• -o <name> — Object name used to name output file. your output file needs a name and this is where you give it one 🏷️
• -r <radius> — Search radius in arcsec (default 10). how wide your little search circle is, and yes the default is literally 10 arcsec 🎯
• -s — Sort by right ascension instead of flux. RA order this time, not brightness 🔥
• -t — Tab table to standard output as well as file. so you get the tab table in both places, not just the file 🍓
• -u <num> — Plate number for catalog sources (0=all). 0 means all of them, no cap 🧚
• -v — Verbose listing of processing intermediate results. she's chatty, she's telling you everything she's doing along the way 🙈
• -w — Write tab table output file imagename.uac. this is the one that redirects the output to a file instead of stdout ⭐

⚠️ heads up bestie: -b and -j are the coordinate-system besties — the synopsis says [-b or -j], so pick your era, don't be greedy 💀

---

🔭 SEE ALSO 🔭

• scat(1)
• sua2(1)
• imusa2(1)
• sgsc(1)

---

👑 AUTHOR 👑

Jessica Mink, SAO (jmink@cfa.harvard.edu) 💜

---

and that's the whole page, bestie — no notes, no crumbs. this was the WCS version of the susa2(1) General Commands Manual, dated 9 June 2000. slay 💅✨