sua2(1)

✨ sua2(1) — NAME ✨

Hiii bestie 🫶 you just pulled up the General Commands Manual, section 1, and the star of the show is sua2. So what is it, fr fr?

sua2 — Find USNO-A2.0 Catalog stars in a square on the sky 🌟

That's it. That's the whole vibe. Sky square, catalog stars, let's go. 💅

---

🌈 SYNOPSIS 🌈

sua2 [options] ra dec system

Three little positional besties (ra, dec, system) plus whatever options your heart desires. Simple. Iconic. ✨

---

🦋 DESCRIPTION 🦋

So suac finds all of the U.S. Naval Observatory A2.0 Catalog objects in a specified region of the sky and lists their sky positions and magnitudes in order of brightness. 🔭

(not me noticing the page says suac and not sua2 — I'm literally just reading what's on the page, bestie, don't come for me 😭)

Where does all that gorgeous data go? To standard out, obviously — unless you set the -w flag, in which case it goes to objectname.uac or search.uac instead. 🎀

And one more lil detail you should know: it is a link to scat. Periodt.

---

💅 OPTIONS 💅

Okay this is the part you actually came for. Every single flag, no skips, no cuts. 🌸

• -a — list single closest catalog source
• -b — Output B1950 (FK4) coordinates
• -d — Sort by distance from center instead of flux
• -e — Output ecliptic coordinates
• -f — Output search center for other programs
• -g — Output galactic coordinates
• -h — Print heading, else do not
• -i — Print catalog object name, not catalog number (=ua2_region_number)
• -j — Output J2000 (FK5) coordinates
• -l — Print center and closest star on one line
• -m [<bright magnitude>] <faint magnitude> — Limiting catalog magnitude(s) (default none, bright -2 if only faint is given)
• -n <num> — Number of brightest stars to print
• -o <name> — Object name used to name output file
• -p — Sort by distance from search center instead of brightness
• -q <years> — Equinox of output positions in years
• -r <radius> — Search box half-width in arcsec or dd:mm:ss If negative, this is a radius; if two numbers, first is in right ascension, second is in declination. (default is 10, that is a 20x20 arcsec box)
• -s — Sort by right ascension instead of flux
• -t — Tab table output
• -u <num> — Print X Y instead of number in front of non-tab entry
• -v — Verbose listing of processing intermediate results
• -w — Write tab table output file imagename.uac
• -y — Epoch of output positions in years

Heads up on -m: if you only hand over the faint magnitude, the bright one defaults to -2. And on -r, if you give it a negative number that's a radius, and if you give it two numbers the first is in right ascension and the second is in declination. Default is 10, i.e. a 20x20 arcsec box. You got this. 💖

---

👀 SEE ALSO 👀

Go bother these queens when you're done here:

• scat(1)
• susac(1)
• imuac(1)
• sgsc(1)

---

👑 AUTHOR 👑

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

---

And that's the whole page, bestie!! 🦋 This one's brought to you by the WCS girlies and dated 19 November 1999 — yeah, she's a vintage icon and she still slays. Mwah. 💋✨