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

Name

6       imcatalog - List catalog stars in FITS and IRAF image files
7

Synopsis

9       imcatalog [options] FITS or IRAF file(s)
10

Description

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

Options

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
22       -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
27       -d     Output RA,Dec positions in fractional degrees
28
29       -e     Output in ecliptic longitude and latitude
30
31       -g     Output in galactic longitude and latitude
32
33       -h     Print heading, else do not
34
35       -i     Print name instead of number in region file
36
37       -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
41       -k <keyword>
42              Add this keyword to output from tab table search
43
44       -m [<bright magnitude>] <faint magnitude>
45              Limiting catalog magnitude(s) (default none, bright -2  if  only
46              faint is given)
47
48       -n <num>
49              Number of brightest stars to print
50
51       -o <type>
52              Set  HST  Guide Star object class to print (0=stars, 3=nonstars,
53              -1=all, -2=band)
54
55       -p <scale>
56              Initial plate scale in arcsec per pixel (default from file)
57
58       -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
67       -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  im‐
71              age.  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
77       -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
81       -t     Tab table to standard output as well as file
82
83       -u num USNO catalog single plate number to accept
84
85       -v     Verbose listing of processing intermediate results
86
87       -w     Write tab table output file imagename.cat
88
89       -x x y X and Y coordinates of reference pixel  (default  is  CRPIXn  or
90              center of image)
91
92       -y epoch
93              Epoch of image for proper motions
94
95       -z     Use AIPS classic projections instead of WCSLIB; use CD matrix or
96              CDELT instead of polynomial solution.
97

See Also

99       scat()
100
101

Web Page

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

Author

107       Jessica Mink, SAO (jmink@cfa.harvard.edu)
108
109
110
11130 January 2003                    WCSTools                       imcatalog(1)