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

Name

6       imstar - Find stars in FITS and IRAF image files
7

Synopsis

9       imstar   [options]  [FITS  or  IRAF  filename]  or [@file of image file
10       names]
11

Description

Options

14       <hh:mm:ss> <dd:mm:ss> [J2000, B1950]
15              Coordinates for center (or reference pixel if -x is used).
16
17       -a <angle>
18              Image rotation angle in degrees (default 0).  If multiple of 90,
19              rotate  image  before  search and set WCS angle to zero; if not,
20              put in WCS.
21
22       -b     Output B1950 (FK4) coordinates (default=image equinox)
23
24       -d <catalog name>
25              Read this DAOFIND style catalog of X, Y, and  magnitude  instead
26              of  searching  for  stars  in  the  image.  The format is simply
27              white-space-separated numbers on a line, with # at the beginning
28              of comment lines.
29
30       -e <num>
31              Number of pixels to ignore around image edge
32
33       -f     Write  a  simple  ASCII  catalog  file  instead  of tab table or
34              DAOFIND format (number RA DEC mag ... per line, with  two  lines
35              of header info)
36
37       -h     Print heading, else do not
38
39       -i <num>
40              Minimum peak value for star in image (<0=-sigma) Setting this to
41              reject all but 10-15 stars is a good way to speed up  the  star-
42              finding  process.  If num is less than zero, the minimum peak is
43              -num image  pixel  standard  deviations.   Setting  this  number
44              rejects faint stars early in the selection process for a signif‐
45              icant saving in computing time.
46
47       -j     Output J2000 (FK5) coordinates (default=image equinox)
48
49       -k     Print each star as it is found for debugging
50
51       -l     Reflect the image  left  <->  right  before  rotating  (-a)  and
52              searching for stars.
53
54       -m <magnitude>
55              Magnitude offset
56
57       -n     Number of brightest stars to print
58
59       -o     Output  star list in DAOFIND format.  The first three numbers on
60              each line of the output file are X, Y, and magnitude,  separated
61              by  one  or  more  blanks  or a tab.  Lines beginning with # are
62              ignored.
63
64       -p <num>
65              Plate scale in arcsec per pixel (default 0)
66
67       -q <c|d|o|s|x|v|+>
68              Output region file shape for  SAOimage  (default  o)  Characters
69              mean:  c>ross,  d>iamond, s>quare, o>circle, x=X, v>ary with GSC
70              type, +>cross.
71
72       -r     Maximum radius for star in pixels
73
74       -s     Sort by RA instead of flux
75
76       -t     Output in Starbase tab table format
77
78       -v     Verbose listing of processing intermediate results
79
80       -w     Write output to a file in addition to standard out.  If DAO for‐
81              mat (-o), create the name by adding .dao to the image file name.
82              If Starbase format (-t), create the name by adding .tab  to  the
83              image  file  name.   If  ASCII  format  (-f), create the name by
84              adding .stars to the image file name.
85
86       -x <X> <Y>
87              X and Y coordinates of reference pixel  (if  not  in  header  or
88              image center)
89
90       -z     Use  AIPS  classic  projection code (for "-SIN", "-TAN", "-ARC",
91              "-NCP", "-GLS", "-MER",  "-AIT"  and  "-STG"  only)  instead  of
92              WCSLIB proposed standard projection code.
93
94

Web Page

96       http://tdc-www.harvard.edu/software/wcstools/imstar/
97
98

Author

100       Jessica Mink, SAO (jmink@cfa.harvard.edu)
101
102
103
1046 July 2001                        WCSTools                          imstar(1)