DOKK / manpages / debian 11 / wcstools / scat.1.en
scat(1) General Commands Manual scat(1)

scat - Find catalog stars in a square or circle on the sky

scat [options] [-b or -j] ra dec [equinox]

scat is a utility for finding all of the Hubble Space Telescope Guide Star Catalog (GSC), U.S. Naval Observatory A2.0 (UA2), B1.0 (UB1), SA2.0 (USA2), or UJ (UJC) Catalogs, or locally catalogued objects in a specified region of the sky and listing their sky coordinates to standard output. If the -w flag is set, they are written to a file objectname.catalogname, where objectname is given by the argument to -o on the command line, defaulting to "search", and catalogname is given by the argument to -c on the command line. The catalog defaults to the GSC, if no -c argument is present. scat resembles rgsc(1) and star(1), which can search from lists of coordinates but cannot sort the output. sgsc, suac, and susac are links to this program.1

List the single closest catalog source
Output B1950 (FK4) coordinates around this center
Reference catalog (gsc(=HST GSC), ua2(=USNO-A2.0), TMC(=2MASS Point Source Catalog), gsc2(=GSC II), ub1(=USNO-B1.0), local file, etc.)

Output RA and Dec in degrees instead of hh:mm:ss dd:mm:ss
Output ecliptic coordinates
Output search center for other programs
HST Guide Star Catalog object class (0=stars 3=galaxies -1=all)
Print search and column heading, else do not
Print catalog object name, not catalog number
Output J2000 (FK5) coordinates around this center
Add value of this keyword to end of output lines from a tab table search
Print search center and closest star on one line
Limiting catalog magnitude(s) (default none, bright -2 if only faint is given)
Number of brightest stars to print
Object name used for output file naming
Equinox of output position in fractional years
Halfwidth (-radius if negative) of search area in arcseconds (default 10)
Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance from center, or (r)ight ascension.
Tab table to standard output or file
Print x y instead of number in front of non-tab output, before RA and Dec or add x and y columns to end of tab output line
Verbose listing of processing intermediate results
Write output file objectname.catalog or search.catalog if -o is not used.
GSC object type (0=stars 3=galaxies -1=all -2=bands)
Epoch of output positions in fractional years (for proper motion only)
Append to existing output file search.catalog or objectname.catalog. Start file if it does not already exist.

imcat()

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

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

WCSTools 30 January 2003