getpix(1)

📦
version 3.9.7 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🎀 NAME 🎀

getpix — -Display FITS or IRAF image values

okay so bestie, real talk: this is the tool that pulls actual pixel values out of a FITS or IRAF 2-D image and shows them to you. that's it. that's the whole gig. and it ATE. 💅

✨ 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

like, yes, setpix is in there too. no i will not explain. okay i'll explain: it's in the synopsis, it's staying in the synopsis. 🫶

💖 DESCRIPTION 💖

so what this icon actually does: it displays the values of a list of specified pixels, or ranges of pixels, in a FITS or IRAF 2-D image. 🌈

and as a lil bonus, pixel values from a file of x y pairs may be displayed too. so you can absolutely just hand it a whole list and let it cook. ✨

👑 OPTIONS 👑

every single one. no skipping. i know her. 💜

  • filename — the name of the IRAF image header file or the FITS file. and heads up bestie, this one must be present. like it's not optional, it's the main character. no filename, no show. 😭
  • @coordfile — a file where the x y coordinates are the first two tokens on each line.
  • xrange yrange — image coordinate x and y ranges, written as x1-x2 y1-y2, or just straight up lists of x and y coordinates. x is the horizontal one, y runs along the vertical axis, and it all starts at 1,1 in the lower left corner of the image. and if either range is "0", then all of the coordinate values along that axis get displayed. zero means everything, periodt.
  • -d number — set the number of decimal places in the displayed pixel values.
  • -e pixel value range — print the range of pixel values in the specified image region.
  • -f name — write the specified region out to a FITS file.
  • -g num — keep pixels with values greater than this. (in the synopsis you'll see it hanging out as -g val too, same energy.)
  • -h — print the file name on the line above the pixel values.
  • -i — ignore the first token on each line of the coordinate file.
  • -l num — keep pixels with values less than this. (-l val in the synopsis, still her.)
  • -m — print the mean of the pixel values in the specified image region.
  • -n num — how many pixel values get printed per line.
  • -o format — output format in C style, without the leading %.
  • -p — label the pixel rows and columns.
  • -r num — radius (<0=box) to extract, in degrees/arcsec.
  • -s — print x y value with no punctuation.
  • -t — separate the columns in the table with tabs instead of spaces.
  • -v — verbose header with more info about the image, and it labels pixel coordinates from the input list. she's chatty and we love her for it. 🦋
  • -y — display x as rows (vertically) and y as columns (horizontally). yes, the flip. it's giving chaos but it's on purpose. 🔥

🌸 AUTHOR 🌸

Jessica Mink, SAO (jmink@cfa.harvard.edu) — the legend herself. bow down. 🙇‍♀️👑

okay that's the whole page bestie, go read some pixels 💖

this was WCSTools, dated 14 May 2020 — getpix(1), slay, goodbye, mwah 🎀✨

📦 where this page comes from