imstar(1) [debian man page]
imstar(1) General Commands Manual imstar(1) Name imstar - Find stars in FITS and IRAF image files Synopsis imstar [options] [FITS or IRAF filename] or [@file of image file names] Description Options <hh:mm:ss> <dd:mm:ss> [J2000, B1950] Coordinates for center (or reference pixel if -x is used). -a <angle> Image rotation angle in degrees (default 0). If multiple of 90, rotate image before search and set WCS angle to zero; if not, put in WCS. -b Output B1950 (FK4) coordinates (default=image equinox) -d <catalog name> Read this DAOFIND style catalog of X, Y, and magnitude instead of searching for stars in the image. The format is simply white- space-separated numbers on a line, with # at the beginning of comment lines. -e <num> Number of pixels to ignore around image edge -f Write a simple ASCII catalog file instead of tab table or DAOFIND format (number RA DEC mag ... per line, with two lines of header info) -h Print heading, else do not -i <num> Minimum peak value for star in image (<0=-sigma) Setting this to reject all but 10-15 stars is a good way to speed up the star-find- ing process. If num is less than zero, the minimum peak is -num 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 (default=image equinox) -k Print each star as it is found for debugging -l Reflect the image left <-> right before rotating (-a) and searching for stars. -m <magnitude> Magnitude offset -n Number of brightest stars to print -o Output star list in DAOFIND format. 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. -p <num> Plate scale in arcsec per pixel (default 0) -q <c|d|o|s|x|v|+> Output region file shape for SAOimage (default o) Characters mean: c>ross, d>iamond, s>quare, o>circle, x=X, v>ary with GSC type, +>cross. -r Maximum radius for star in pixels -s Sort by RA instead of flux -t Output in Starbase tab table format -v Verbose listing of processing intermediate results -w Write output to a file in addition to standard out. If DAO format (-o), create the name by adding .dao to the image file name. If Starbase format (-t), create the name by adding .tab to the image file name. If ASCII format (-f), create the name by adding .stars to the image file name. -x <X> <Y> X and Y coordinates of reference pixel (if not in header or image center) -z Use AIPS classic projection code (for "-SIN", "-TAN", "-ARC", "-NCP", "-GLS", "-MER", "-AIT" and "-STG" only) instead of WCSLIB pro- posed standard projection code. Web Page http://tdc-www.harvard.edu/software/wcstools/imstar/ Author Doug Mink, SAO (dmink@cfa.harvard.edu) 6 July 2001 WCSTools imstar(1)
Check Out this Related Man Page
scat(1) General Commands Manual scat(1) Name scat - Find catalog stars in a square or circle on the sky Synopsis scat [options] [-b or -j] ra dec Description scat is a utility for finding all of the Hubble Space Telescope Guide Star Catalog (GSC), U.S. Naval Observatory A2.0 (UA2), B1.0 (UB1), SA2.0 (USA2), or UJ (UJC) Catalogs, or locally catalogued objects in a specified region of the sky and listing their sky coordinates to standard output. If the -w flag is set, they are written to a file objectname.catalogname, where objectname is given by the argument to -o on the command line, defaulting to "search", and catalogname is given by the argument to -c on the command line. The catalog defaults to the GSC, if no -c argument is present. scat resembles rgsc(1) and star(1), which can search from lists of coordinates but cannot sort the output. sgsc, suac, and susac are links to this program.1 Options -a List the single closest catalog source -b <RA> <Dec> Output B1950 (FK4) coordinates around this center -c <name> Reference catalog (gsc(=HST GSC), ua2(=USNO-A2.0), TMC(=2MASS Point Source Catalog), gsc2(=GSC II), ub1(=USNO-B1.0), local file, etc.) -d Output RA and Dec in degrees instead of hh:mm:ss dd:mm:ss -e Output ecliptic coordinates -f Output search center for other programs -g <class> HST Guide Star Catalog object class (0=stars 3=galaxies -1=all) -h Print search and column heading, else do not -i Print catalog object name, not catalog number -j <RA> <Dec> Output J2000 (FK5) coordinates around this center -k <keyword> Add value of this keyword to end of output lines from a tab table search -l Print search center and closest star on one line -m [<bright magnitude>] <faint magnitude> Limiting catalog magnitude(s) (default none, bright -2 if only faint is given) -n <num> Number of brightest stars to print -o <name> Object name used for output file naming -q <year> Equinox of output position in fractional years -r <radius> Halfwidth (-radius if negative) of search area in arcseconds (default 10) -s d|m|n|p|r Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance from center, or (r)ight ascension. -t Tab table to standard output or file -u <x> <y> Print x y instead of number in front of non-tab output, before RA and Dec or add x and y columns to end of tab output line -v Verbose listing of processing intermediate results -w Write output file objectname.catalog or search.catalog if -o is not used. -x <type> GSC object type (0=stars 3=galaxies -1=all -2=bands) -y <year> Epoch of output positions in fractional years (for proper motion only) -z Append to existing output file search.catalog or objectname.catalog. Start file if it does not already exist. See Also imcat() Web Page http://tdc-www.harvard.edu/software/wcstools/scat/ Author Doug Mink, SAO (dmink@cfa.harvard.edu) 30 January 2003 WCSTools scat(1)