Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

setpix(1) [debian 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)

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