1imcat(1) General Commands Manual imcat(1)
2
6 imcat - List catalog stars in FITS and IRAF image files
7
9 imcat [options] FITS or IRAF file(s)
10
12 Search given catalog withing area described by the world coordinate
13 system in an image header. May be called as imuac to search the USNO A
14 1.0 catalog, imusac to search the USNO SA 1.0 catalog, or imgsc to
15 search the HST Guide Star Catalog.
16
18 -b [<RA> <Dec>]
19 Output in B1950, optional new image center in B1950 (FK4) RA and
20 Dec to replace that in image header
21 -c <name>
23 Reference catalog (gsc(=HST GSC), ua2(=USNO-A2.0), TMC(=2MASS
24 Point Source Catalog), gsc2(=GSC II), ub1(=USNO-B1.0), local
25 file, etc.)
26 -d Output RA,Dec positions in fractional degrees
28 -e Output in ecliptic longitude and latitude
30 -g Output in galactic longitude and latitude
32 -h Print heading, else do not
34 -i Print name instead of number in region file
36 -j [<RA> <Dec>]
38 Output in J2000, optional new image center in J2000 (FK5) RA and
39 Dec to replace that in image header
40 -k <keyword>
42 Add this keyword to output from tab table search
43 -m [<bright magnitude>] <faint magnitude>
45 Limiting catalog magnitude(s) (default none, bright -2 if only
46 faint is given)
47 -n <num>
49 Number of brightest stars to print
50 -o <type>
52 Set HST Guide Star object class to print (0=stars, 3=nonstars,
53 -1=all, -2=band)
54 -p <scale>
56 Initial plate scale in arcsec per pixel (default from file)
57 -q <c|d|o|s|x|v|+>
59 Write SAOimage region file with this shape, o=circle, s=square,
60 d=diamond, +=cross, and x=X, with the radius scaled with magni‐
61 tude unless specified with a -r command line entry. v will cause
62 stellar Guide Stars to plot with a + and nonstellar Guide Stars
63 to plot with an x. If character is is preceded by p, the size
64 specified by the -r command is assumed to be in pixels, not arc‐
65 seconds. A p alone specifies a circle in pixels.
66 -r <radius>
68 Write SAOimage region file with shapes (default CIRCLE) of this
69 radius in arcseconds. SAOimage can then read this file, with
70 will have positions and radii in pixels and plot it over an
71 image. If the radius is specified as zero, the output radii will
72 scale between 5 and dim/100 over the range of magnitudes of
73 sources found in the image area. If the -q option is specified
74 with a 'p' in it, this number is assumed to be in pixels instead
75 of arcseconds.
76 -s d|m|n|p|r|x|y
78 Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance from
79 center, (r)ight ascension, image (x) or (y).
80 -t Tab table to standard output as well as file
82 -u num USNO catalog single plate number to accept
84 -v Verbose listing of processing intermediate results
86 -w Write tab table output file imagename.cat
88 -x x y X and Y coordinates of reference pixel (default is CRPIXn or
90 center of image)
91 -y epoch
93 Epoch of image for proper motions
94 -z Use AIPS classic projections instead of WCSLIB; use CD matrix or
96 CDELT instead of polynomial solution.
97
99 scat()
100
103 http://tdc-www.harvard.edu/software/wcstools/imcat/
104
107 Jessica Mink, SAO (jmink@cfa.harvard.edu)
10830 January 2003 WCSTools imcat(1)