imgsc(1)

📦
version 3.9.7 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💫 NAME 💫

imgsc — bestie, this is the little link that goes and finds HST GSC stars hiding inside your FITS or IRAF image files 🌟

Like, literally. That's the whole job. It's giving "where my stars at" energy and it always delivers 💅

✨ SYNOPSIS ✨

imgsc [options] FITS or IRAF file(s)

Feed it a file (or several, she's flexible 🫶) and she'll go sniffing through the sky.

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — imgsc searches the HST Guide Star Catalog inside the area that the world coordinate system in an image header is describing. That's it, that's the vibe. 🌸

Important lore: this is a link to imcat, not its own separate executable. So it's not a whole new girl, she's just imcat in a different outfit 👑 no cap.

🎀 OPTIONS 🎀

  • -b [<RA> <Dec>] — Output in B1950, and optionally you can drop a new image center in B1950 (FK4) RA and Dec 💜
  • -c <name> — Reference catalog (gsc, ujc, or tab table file
  • -g <class> — Guide Star Catalog class (-1=all,0,3 (default -1)
  • -h — Print heading, else do not 📝
  • -j [<RA> <Dec>] — Output in J2000, and optionally a new image center in J2000 (FK5) RA and Dec ✨
  • -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 🔥
  • -p <scale> — Initial plate scale in arcsec per pixel (default 0) 📐
  • -s — Sort by RA instead of flux 🧚
  • -t — Tab table to standard output as well as file 📄
  • -v — Verbose listing of processing intermediate results 🗣️
  • -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. 🌀

🌈 SEE ALSO 🌈

  • imcat()
  • imuac()
  • imusac()
  • scat()

the whole friend group, honestly 💖

💌 AUTHOR 💌

Jessica Mink, SAO (jmink@cfa.harvard.edu) — icon, legend, the moment 👑

and that's a wrap, bestie 🎀 this page came straight out of the WCSTools era, section 1 of the manual, dated 14 April 1998 — yeah she's vintage but she still slays 💅✨

📦 where this page comes from