.TH getpix 1  WCSTools "14 May 2020"
.SH Name
getpix \-Display FITS or IRAF image values
.SH Synopsis
setpix [\-vn] file.fts [x_range y_range value] [@valuefile]
getpix [\-vp][\-n num][\-g val][\-l val] file.fits x_range y_range
getpix [\-vp][\-n num][\-g val][\-l val] file.fits x1 y1 x2 y2 ... xn yn
getpix [\-vp][\-n num][\-g val][\-l val] file.fits @file
.SH Description
Display the values of list of specified pixels or ranges of pixels in a FITS or
IRAF 2-D image. Pixel values from a file of x y pairs may be displayed
.SH Options
.TP
.B filename 
Name of IRAF image header file or FITS file. This must be present. 
.TP
.B @coordfile 
File with x y coordinates as first two tokens on lines
.TP
.B xrange yrange 
Image coordinate x and y ranges as x1-x2 y1-y2 or lists of x and y
coordinates, where x is the horizontal and y is along the vertical axis
starting at 1,1 in the lower left corner of the image. If either range is "0",
all of the coordinate values along that axis are displayed.
.TP
.B \-d number
Set the number of decimal places in displayed pixel values
.TP
.B \-e pixel value range
Print range of pixel values in specified image region
.TP
.B \-f name
Write specified region to a FITS file
.TP
.B \-g num
Keep pixels with values greater than this
.TP
.B \-h
Print file name on line above pixel values
.TP
.B \-i
Ignore first token per line of coordinate file
.TP
.B \-l num
Keep pixels with values less than this
.TP
.B \-m
Print mean of pixel values in specified image region
.TP
.B \-n num
Number of pixel values printed per line
.TP
.B \-o format: Output format in C style without leading %
.TP
.B \-p
Label pixel rows and columns
.TP
.B \-r num
Radius (<0=box) to extract in degrees/arcsec
.TP
.B \-s
Print x y value with no punctuation
.TP
.B \-t
Separate columns in table with tabs instead of spaces 
.TP
.B \-v
Verbose header with more about the image and label pixel coordinates from input list
.TP
.B \-y
Display x as rows (vertically) and y as columns (horizontally)

.SH Author
Jessica Mink, SAO (jmink@cfa.harvard.edu)