imcatalog(1)

🌟 imcatalog(1) 🌟

okay bestie, welcome to the General Commands Manual entry for imcatalog. It's literally about listing catalog stars in FITS and IRAF image files, and it's giving observatory-bestie energy. Let's go. 🫶✨

✨ NAME ✨

imcatalog — list catalog stars in FITS and IRAF image files. That's the whole name vibe. 💅

🌈 SYNOPSIS 🌈

imcatalog [options] FITS or IRAF file(s)

💫 DESCRIPTION 💫

So what it does: it searches the given catalog within the area described by the world coordinate system in an image header. The way that it can also be called as imuac to search the USNO A 1.0 catalog, as imusac to search the USNO SA 1.0 catalog, or as imgsc to search the HST Guide Star Catalog. Multiple names, one icon. 👑

🎀 OPTIONS 🎀

• -b [<RA> <Dec>] — Output in B1950. You can optionally drop a new image center in B1950 (FK4) RA and Dec to replace the one in the image header. Very retro, very slay. 💖
• -c <name> — Reference catalog. The options include gsc (=HST GSC), ua2 (=USNO-A2.0), TMC (=2MASS Point Source Catalog), gsc2 (=GSC II), ub1 (=USNO-B1.0), a local file, etc. Pick your fave. ✨
• -d — Output RA,Dec positions in fractional degrees. Numbers but make them decimal. 🍓
• -e — Output in ecliptic longitude and latitude. Zodiac-core. 🌙
• -g — Output in galactic longitude and latitude. Galaxy brain. 🌌
• -h — Print heading, else do not. Heading on or heading off, your call. 💅
• -i — Print name instead of number in region file. Names > numbers, honestly. 🎀
• -j [<RA> <Dec>] — Output in J2000. You can optionally pass a new image center in J2000 (FK5) RA and Dec to replace the one in the image header. Modern era, bestie. ✨
• -k <keyword> — Add this keyword to output from tab table search. Keyword moment. 🔑
• -m [<bright magnitude>] <faint magnitude> — Limiting catalog magnitude(s). Default is none, and bright is -2 if only faint is given. Magnitude boundaries, but make it cute. ⭐
• -n <num> — Number of brightest stars to print. Only the top num, periodt. 👑
• -o <type> — Set HST Guide Star object class to print: 0=stars, 3=nonstars, -1=all, -2=band. Choose your fighter. 💀
• -p <scale> — Initial plate scale in arcsec per pixel (default from file). Arcsec per pixel, not pixels per arcsec. We love precision. 📏
• -q <c|d|o|s|x|v|+> — Write SAOimage region file with this shape: o=circle, s=square, d=diamond, +=cross, and x=X, with the radius scaled with magnitude unless specified with a -r command line entry. v will cause stellar Guide Stars to plot with a + and nonstellar Guide Stars to plot with an x. If character is is preceded by p, the size specified by the -r command is assumed to be in pixels, not arcseconds. A p alone specifies a circle in pixels. That's a lot of shapes, but we ate. 🔥
• -r <radius> — Write SAOimage region file with shapes (default CIRCLE) of this radius in arcseconds. SAOimage can then read this file, with will have positions and radii in pixels, and plot it over an image. If the radius is specified as zero, the output radii will scale between 5 and dim/100 over the range of magnitudes of sources found in the image area. If the -q option is specified with a 'p' in it, this number is assumed to be in pixels instead of arcseconds. Radius glow-up. 🌈
• -s d|m|n|p|r|x|y — Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance from center, (r)ight ascension, image (x) or (y). Sorting is self-care. 🧚
• -t — Tab table to standard output as well as file. Double output, double trouble. 💖
• -u num — USNO catalog single plate number to accept. That's the plate we're accepting, bestie. 🍽️
• -v — Verbose listing of processing intermediate results. Spill the tea, program. ☕
• -w — Write tab table output file imagename.cat. File named after the image, cute. 🎀
• -x x y — X and Y coordinates of reference pixel (default is CRPIXn or center of image). Reference pixel realness. 📍
• -y epoch — Epoch of image for proper motions. Time-travel but for proper motions. ⏳
• -z — Use AIPS classic projections instead of WCSLIB; use CD matrix or CDELT instead of polynomial solution. Classic mode, no cap. 💅

🦋 SEE ALSO 🦋

scat()

🌐 WEB PAGE 🌐

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

👑 AUTHOR 👑

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

💖 And that's the whole page, bestie. It's from 30 January 2003, WCSTools, imcatalog(1). Stay iconic. 💅✨