1scat(1)                     General Commands Manual                    scat(1)
2
3
4

Name

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

Synopsis

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

Description

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

Options

25       -a     List the single closest catalog source
26
27       -b <RA> <Dec>
28              Output B1950 (FK4) coordinates around this center
29
30       -c <name>
31              Reference  catalog  (gsc(=HST  GSC), ua2(=USNO-A2.0), TMC(=2MASS
32              Point Source Catalog),  gsc2(=GSC  II),  ub1(=USNO-B1.0),  local
33              file, etc.)
34
35       -d
36               Output RA and Dec in degrees instead of hh:mm:ss dd:mm:ss
37
38       -e     Output ecliptic coordinates
39
40       -f     Output search center for other programs
41
42       -g <class>
43              HST Guide Star Catalog object class (0=stars 3=galaxies -1=all)
44
45       -h     Print search and column heading, else do not
46
47       -i     Print catalog object name, not catalog number
48
49       -j <RA> <Dec>
50              Output J2000 (FK5) coordinates around this center
51
52       -k <keyword>
53              Add  value of this keyword to end of output lines from a tab ta‐
54              ble search
55
56       -l     Print search center and closest star on one line
57
58       -m [<bright magnitude>] <faint magnitude>
59              Limiting catalog magnitude(s) (default none, bright -2  if  only
60              faint is given)
61
62       -n <num>
63              Number of brightest stars to print
64
65       -o <name>
66              Object name used for output file naming
67
68       -q <year>
69              Equinox of output position in fractional years
70
71       -r <radius>
72              Halfwidth  (-radius  if  negative)  of search area in arcseconds
73              (default 10)
74
75       -s d|m|n|p|r
76              Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance  from
77              center, or (r)ight ascension.
78
79       -t     Tab table to standard output or file
80
81       -u <x> <y>
82              Print  x  y instead of number in front of non-tab output, before
83              RA and Dec or add x and y columns to end of tab output line
84
85       -v     Verbose listing of processing intermediate results
86
87       -w     Write output file objectname.catalog or search.catalog if -o  is
88              not used.
89
90       -x <type>
91              GSC object type (0=stars 3=galaxies -1=all -2=bands)
92
93       -y <year>
94              Epoch of output positions in fractional years (for proper motion
95              only)
96
97       -z     Append to existing output file search.catalog or objectname.cat‐
98              alog.  Start file if it does not already exist.
99
100

See Also

102       imcat()
103
104

Web Page

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

Author

110       Jessica Mink, SAO (jmink@cfa.harvard.edu)
111
112
113
11430 January 2003                    WCSTools                            scat(1)