imcatalog(1) [debian man page]

imcat(1)						      General Commands Manual							  imcat(1)

Name
       imcat - List catalog stars in FITS and IRAF image files

Synopsis
       imcat [options] FITS or IRAF file(s)

Description
       Search given catalog withing area described by the world coordinate system in an image header.  May be called as imuac to search the USNO A
       1.0 catalog, imusac to search the USNO SA 1.0 catalog, or imgsc to search the HST Guide Star Catalog.

Options
       -b [<RA> <Dec>]
	      Output in B1950, optional new image center in B1950 (FK4) RA and Dec to replace that in image header

       -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,Dec positions in fractional degrees

       -e     Output in ecliptic longitude and latitude

       -g     Output in galactic longitude and latitude

       -h     Print heading, else do not

       -i     Print name instead of number in region file

       -j [<RA> <Dec>]
	      Output in J2000, optional new image center in J2000 (FK5) RA and Dec to replace that in image header

       -k <keyword>
	      Add this keyword to output from tab table search

       -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 <type>
	      Set HST Guide Star object class to print (0=stars, 3=nonstars, -1=all, -2=band)

       -p <scale>
	      Initial plate scale in arcsec per pixel (default from file)

       -q <c|d|o|s|x|v|+>
	      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.  If character is is preceded by p, the size specified by the -r command is assumed to be in pixels, not arcseconds. A p
	      alone specifies a circle in pixels.

       -r <radius>
	      Write SAOimage region file with shapes (default CIRCLE) of this radius in arcseconds. SAOimage can then read this  file,	with  will
	      have  positions  and  radii  in  pixels  and  plot it over an image. If the radius is specified as zero, the output radii will scale
	      between 5 and dim/100 over the range of magnitudes of sources found in the image area. If the -q option is specified with a  'p'	in
	      it, this number is assumed to be in pixels instead of arcseconds.

       -s d|m|n|p|r|x|y
	      Sort by (d)eclination, (m)agnitude, (n)o sort, (p)distance from center, (r)ight ascension, image (x) or (y).

       -t     Tab table to standard output as well as file

       -u num USNO catalog single plate number to accept

       -v     Verbose listing of processing intermediate results

       -w     Write tab table output file imagename.cat

       -x x y X and Y coordinates of reference pixel (default is CRPIXn or center of image)

       -y epoch
	      Epoch of image for proper motions

       -z     Use AIPS classic projections instead of WCSLIB; use CD matrix or CDELT instead of polynomial solution.

See Also
       scat()

Web Page
       http://tdc-www.harvard.edu/software/wcstools/imcat/

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

30 January 2003 						     WCSTools								  imcat(1)

Check Out this Related Man Page

setpix(1) General Commands Manual setpix(1)

Name
setpix - Set FITS or IRAF image values

Synopsis
setpix [-vn] file.fts [x_range y_range value] [@valuefile]

Description
Set a specified pixel or range of pixels in a FITS or IRAF image to a specified value. More than one range of pixels and values may be
specified on one command line. A file of xrange yrange value triplets may be used to set multiple regions at once. The image may be over-
written or a new image created.

Options
filename
Name of IRAF image header file or FITS file. This must be present.

@coordfile
Name of file containing lines of the format
xrange yrange value where xrange and yrange are of the format n or n-n or n,n,n or n-n,n-n and value my be integer or
floating point. value will be converted to the type of the image. If a range is 0, the entire row or column specified by the other
non-zero range will be set to the indicated value. If both ranges are zero, the entire image will be set to the specified value.
New in version 2.6.4.

xrange yrange value
Image coordinate x and y ranges and the value to which that region will be set. Either one of these triplets or a file of triplets,
specified by @filename, must be present. xrange and yrange are of the format n or n-n or n,n,n or n-n,n-n and value my be integer or
floating point. value will be converted to the type of the image. If a range is 0, the entire row or column specified by the other
non-zero range will be set to the indicated value. If both ranges are zero, the entire image will be set to the specified value.
Ranges new in version 2.6.4.

-a <number>
Add constant to pixels

-d <number>
Divide pixels by constant

-i List each line which is dropped

-m <number>
Multiply pixels by constant

-n Write the output to a new file which is named by inserting an e before the file extension. The new file is always written to the
current working directory.

-s <number>
Subtract constant from pixels

-v Print more information about the process

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

6 July 2001 WCSTools setpix(1)

Linux and UNIX Man Pages

imcatalog(1) [debian man page]

Check Out this Related Man Page