setpix(1)

🌸 setpix — like, the manual page ✨

okay bestie, welcome to setpix, a little icon from the WCSTools fam. it's a General Commands Manual situation and honestly? it just sets pixels. but it sets them so well. 💅

🎀 NAME 🎀

setpix — set FITS or IRAF image values. that's it, that's the whole job, and she does it flawlessly. 👑

🦋 SYNOPSIS 🦋

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

💖 DESCRIPTION 💖

so here's the vibe: you take one specific pixel, or a whole range of pixels, in a FITS or IRAF image, and you set it to a value you pick. easy. iconic. no cap.

and like — you're not limited to one range, okay? you can put more than one range-of-pixels-plus-value on a single command line. go off. multiple regions, one command, main character energy.

you can also hand it a file full of xrange yrange value triplets and set a whole bunch of regions all at once. obsessed. 🫶

and the image itself? you get to choose — overwrite the original, or create a new image entirely. your call, bestie.

✨ OPTIONS ✨

• filename — the name of your IRAF image header file or FITS file. this one is required, like literally must be there, no skipping. 🌟
• @coordfile — the name of a file where every line is formatted like this:

xrange yrange value

where xrange and yrange follow the format n or n-n or n,n,n or n-n,n-n, and value can be an integer or a floating point number. value gets converted to the type of the image. here's the tea on ranges: if a range is 0, then the entire row or column specified by the other non-zero range gets set to that value. and if both ranges are 0? the entire image gets set to the specified value. 💀✨

new in version 2.6.4. she's fresh.

• xrange yrange value — the image coordinate x and y ranges, plus the value that region gets set to. either one of these triplets or a file of triplets given by @filename has to be present — pick one, you can't have neither. xrange and yrange are in the format n or n-n or n,n,n or n-n,n-n, and value can be an integer or a floating point number. value gets converted to the type of the image. same range rules as above: a range of 0 means the entire row or column named by the other non-zero range gets set to that value, and if both ranges are 0, the whole entire image gets set to the specified value. 😭 so powerful.

ranges new in version 2.6.4.

• -a <number> — add a constant to the pixels. math queen. ➕
• -d <number> — divide the pixels by a constant. ➗
• -i — list each line which is dropped. keeping receipts, fr fr.
• -m <number> — multiply the pixels by a constant. ✖️
• -n — write the output to a new file, named by inserting an e before the file extension. and heads up: the new file is always written to the current working directory. no exceptions, bestie. 🌈
• -s <number> — subtract a constant from the pixels. ➖
• -v — print more information about the process. she's chatty and we love that for her. 🗣️💬

👑 AUTHOR 👑

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

okay that's the whole page, mwah 💋 — this was setpix(1) from WCSTools, dated 6 July 2001. thanks for coming to my TED talk, now go set some pixels, you gorgeous genius 🧚💜