imusa2(1)

📦 version 3.9.7, in debian bookworm, debian trixie, epel 9, fedora 43, fedora 44, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💫 imusa2 — the manual page, bestie edition 💫

okay so you found your way into the imusa2(1) page of the General Commands Manual and honestly? slay. let's get into it 🫶

🌟 NAME 🌟

imusa2 — find USNO-SA2.0 stars in FITS or IRAF image files. that's the whole vibe. stars. catalogs. images. iconic.

✨ SYNOPSIS ✨

imua2 [options] FITS or IRAF file(s)

(yes it's spelled imua2 in the synopsis, that's literally what's written, don't come for me 💅)

🦋 DESCRIPTION 🦋

so what this does is it searches the USNO-SA2.0 Catalog inside the area that's described by the world coordinate system in an image header. that's the assignment. that's the whole plot.

and the tea is: this is a link to imcat, not a separate executable. so it's giving "I'm not a whole new program, I'm just imcat wearing a different outfit" 💀 lowkey iconic of it.

🎀 OPTIONS 🎀

  • -b [<RA> <Dec>] — output in B1950, and optionally you can drop a new image center in B1950 (FK4) RA and Dec. two args if you're feeling generous.
  • -h — print the heading, else don't. simple as that bestie.
  • -j [<RA> <Dec>] — output in J2000, plus optional new image center in J2000 (FK5) RA and Dec. the modern twin of -b ✨
  • -m [<bright magnitude>] <faint magnitude> — limiting catalog magnitude(s). default is none, and if you only give it the faint one, bright defaults to -2.
  • -n <num> — number of brightest stars to print. just the popular ones, the main characters 👑
  • -p <scale> — initial plate scale in arcsec per pixel. default is 0.
  • -s — sort by RA instead of flux.
  • -t — tab table to standard output as well as file. both. you get both.
  • -u — USNO catalog single plate number to accept.
  • -v — verbose listing of processing intermediate results. for when you wanna see everything happening in real time 🍓
  • -w — write tab table output file imagename.cat.
  • -z — use AIPS classic projections instead of WCSLIB; use CD matrix or CDELT instead of polynomial solution.
ngl -z is doing two things at once and that's highkey its whole personality 🌈

🌸 SEE ALSO 🌸

  • imcat()
  • imgsc()
  • imua2()
  • scat()

🌈 WEB PAGE 🌈

http://tdc-www.harvard.edu/software/wcstools/imcat/imusa2.html

💜 AUTHOR 💜

Jessica Mink, SAO (jmink@cfa.harvard.edu) — periodt, she did that.

and that's the page, bestie! this one came from the WCS source, dated 14 April 1998 — an absolute vintage baddie of a manpage. go find those stars 💖✨🎀

📦 where this page comes from