---
name: "getpix"
section: "1"
platform: "linux"
package: "wcstools"
version: "3.9.7-1.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/getpix"
---

# getpix(1)

## Name

getpix -Display FITS or IRAF image values

## 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

## 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

## Options

- **filename**

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

- **@coordfile**

  File with x y coordinates as first two tokens on lines

- **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.

- **-d number**

  Set the number of decimal places in displayed pixel values

- **-e pixel value range**

  Print range of pixel values in specified image region

- **-f name**

  Write specified region to a FITS file

- **-g num**

  Keep pixels with values greater than this

- **-h**

  Print file name on line above pixel values

- **-i**

  Ignore first token per line of coordinate file

- **-l num**

  Keep pixels with values less than this

- **-m**

  Print mean of pixel values in specified image region

- **-n num**

  Number of pixel values printed per line

- **-o format: Output format in C style without leading %**

  - **-p**

  Label pixel rows and columns

- **-r num**

  Radius (\<0=box) to extract in degrees/arcsec

- **-s**

  Print x y value with no punctuation

- **-t**

  Separate columns in table with tabs instead of spaces

- **-v**

  Verbose header with more about the image and label pixel coordinates from input list

- **-y**

  Display x as rows (vertically) and y as columns (horizontally)

## Author

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