imstar
Command Line Arguments

Commands with no arguments may be combined following a hyphen.
The default output is in tab table format to a file created by adding .stars to the image file name.
filename Name of FITS or IRAF image file. This must be present.
-a angle Set rotation angle to this constant in nominal WCS
-b Output B1950 (FK4) coordinates, overriding equinox of image
-c RA Dec Use this as the center at the image or specified equinox.
-d name Use this DAOFIND output catalog as input instead of searching for stars in the image, and output a table of image positions and sky coordinates. The first three numbers on each line of the input file are X, Y, and magnitude, separated by one or more blanks or a tab. Lines beginning with # are ignored.
-e number Number of pixels to ignore around image edge
-f Write simple ASCII catalog file, not tab table or DAOFIND file.
-h Print heading to output table.
-i peak value To be recorded, a star's peak brightness must be greater than peak value counts. Setting this to reject all but 10-15 stars is a good way to speed up the star-finding process. If peak value is less than zero, the minimum peak is -peak value image pixel standard deviations. Setting this number rejects faint stars early in the selection process for a significant saving in computing time.
-j Output J2000 (FK5) coordinates, overriding equinox of image
-k Print each star as it is found, for debugging or to find the best minimum intensity to use.
-m magnitude offset Add this number to magnitudes from counts.
-n number Number of brightest stars to print
-p arcsec Plate scale in arcseconds per pixel, overriding value in header.
-q osdv+x Write SAOimage region file with this shape, o=circle, s=square, d=diamond, +=cross, and x=X, with the radius scaled with magnitude unless specified with a -r command line entry. v will cause stellar Guide Stars to plot with a + and nonstellar Guide Stars to plot with an x. (Added in version 2.5)
-r number Reject all stars with radius greater than number pixels
-s Sort output list by right ascension instead of flux.
-t Print tab table (Starbase) output format to standard output.
-u Assume image is unsigned if 16-bit integers. (Added in version 2.3)
-v Print more information about process
-w Write output file in DAOFIND format and create the name by adding .dao to the image file name. The first three numbers on each line of the output file are X, Y, and magnitude, separated by one or more blanks or a tab. Lines beginning with # are ignored.
-z Use AIPS classic projection code (for "-SIN", "-TAN", "-ARC", "-NCP", "-GLS", "-MER", "-AIT" and "-STG" only) instead of WCSLIB proposed standard projection code.

Last updated 20 July 2001 by Doug Mink dmink@cfa.harvard.edu

[WCS Programs] Telescope Data Center [imstar]