keyhead(1)

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

💖 KEYHEAD — like, the NAME section but make it cute 💖

okay bestie, gather round, because keyhead is here to Change FITS or IRAF header keyword names and honestly? it's giving glow-up for your headers. ✨

🎀 SYNOPSIS 🎀

sethead [-hknv] <FITS or IRAF file> kw1=kw1a kw2=kwd2a ... kwn=kwdna

(no, that's not a typo, the synopsis says sethead and I am not touching it, periodt 💅)

🌸 DESCRIPTION 🌸

So here's the vibe: keyhead changes the names of keywords in FITS or IRAF image headers. Every current image keyword you wanna mess with gets followed by an equal sign and then a second keyword, with no spaces in between. iykyk.

If you use the -r option, the value of the second keyword gets transferred over to the first one. Otherwise (no -r), the name of the first keyword just gets changed into the second keyword. simple as that, no cap.

Wanna do this to a whole list of files? substitute @<listfile> for the file names on the command line. 🫶

Wanna change a lot of keywords? put them in a file — one pair per line, separated by an = sign with no spaces, and substitute @<keylistfile> on the command line. And if you've got two @ commands present at the same time, the program will figure out on its own which one contains file names and which one contains keywords. main character energy fr fr. 👑

Oh and lowkey important: lines in a keyword list file that don't contain an = are just ignored. 💀

✨ OPTIONS ✨

  • -h — writes a HISTORY line into the output header with the sethead version, the current date and time, and the names of keywords set. 💖
  • -k — writes a KEYHEAD keyword into the output header with the keyhead version, the current date and time, and the names of keywords whose names are changed. And heads up: if a KEYHEAD keyword already exists, the old value gets moved to a HISTORY line before the new value is written. 🌈
  • -n — writes a new file, with an added "e" before the extension. iconic.
  • -r letter — replaces the value of the 1st keyword with the value of the 2nd keyword instead of changing the name of the 1st keyword into the 2nd keyword. the 2nd keyword stays in the header, it's not going anywhere. and if the 1st keyword doesn't exist in the header? it gets created. ✨
  • -v — prints confirmations of each keyword change. very "not me obsessively checking every single one" of you, and honestly? valid. 🦋

🌐 WEB PAGE 🌐

http://tdc-www.harvard.edu/software/wcstools/keyhead.html

go look, bestie, it's right there 💜

👑 AUTHOR 👑

Jessica Mink, SAO (jmink@cfa.harvard.edu) — queen behavior, we stan. 🎀

and that's the whole page, babe!! this was WCSTools, dated 6 July 2001, and yeah it's an oldie but she still ate. mwah, bye bestie 💅✨

📦 where this page comes from