Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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

xy2sky(1)						      General Commands Manual							 xy2sky(1)

Name
       xy2sky - Compute RA Dec from X Y using WCS in FITS and IRAF image files

Synopsis
       xy2sky [-vbjg] [-n ndec] file.fts x1 y1 ... xn yn
       or
       xy2sky [-bdjgv] [-n ndec] file.fts @listfile

Description
       xy2sky  (pronounced X-Y-to-sky) is a utility for getting the world coordinates of a set of image coordinates in a FITS or IRAF image. World
       coordinate system (WCS) information in the image header describes, in a standard way, the relationship between sky  coordinates	and  image
       pixels. This information is used by the program to transform image coordinate (X,Y) pairs to right ascension and declination sky coordinate
       pairs. The current version of the program prints the coordinates at the same equinox as is given in the image header, but  future  versions
       will  allow transformations to B1950/FK4, J2000/FK5, or galactic coordinates. Input and output files in the Starbase format will eventually
       be allowed.

Options
       -a     Append input line after output position

       -b     B1950 (FK4) output

       -d     RA and Dec output in degrees

       -e     Output in ecliptic longitude and latitude in degrees.

       -f <number>
	      Set third dimension for 3-D projections such as CSC

       -g     Galactic longitude and latitude output

       -i     First column is star id; 2nd, 3rd are x,y position

       -j     J2000 (FK5) output

       -m <number>
	      Set mode for output of LINEAR WCS coordinates:  0: x y linear 1: x units y units 2: x y linear units units

       -n <number>
	      Number of decimal places in output RA seconds

       -q <year>
	      Output equinox if not 2000 (-j) or 1950 (-b)

       -t     Output as tab-separated table

       -v     More descriptive output -z Use AIPS classic projections instead of WCSLIB

See Also
       sky2xy(1)

Author
       Doug Mink, SAO (dmink@cfa.harvard.edu)

6 July 2001							     WCSTools								 xy2sky(1)
Man Page