gethead(1)

🌟 NAME 🌟

gethead — the girl who prints out your FITS or IRAF header keyword values, no cap 💅

✨ SYNOPSIS ✨

gethead [-hptv] [-d pathname] [-n num] <FITS or IRAF file> kw1 kw2 ... kwn

💖 DESCRIPTION 💖

Okay bestie, so here's the vibe: gethead goes into the header of the image you handed it and pulls out the values of whatever keywords you asked for. That's it. That's the whole job. Iconic behaviour, honestly. 🎀

By default all those values get listed on one single line, separated by spaces. Cute, compact, efficient.

But wait — the -v flag? That one makes it print the keyword names AND their values, one keyword per line. Very "show your work" of it. 🦋

Now, the party tricks:

• Wanna read keywords from a whole list of files? Just swap out the file names on the command line for @<listfile>. Boom. ✨
• Wanna read a lot of keywords at once? Put them, one per line, in a file and drop @<keylistfile> on the command line. Slay.
• And if you're feeling chaotic and there are two @ commands present? Don't stress — the program will figure out which one holds the file names and which one holds the keywords. It's giving main character energy fr fr. 👑

🎀 OPTIONS 🎀

• -a — Lists the file name even if the keywords aren't found. Petty? No. Thorough. 💅
• -d — Root directory for input files (the default is cwd, aka wherever you already are).
• -e — Outputs the keyword=value's on one line per file.
• -f — Never prints filenames (the default is to print them when there's more than one).
• -g — Outputs the keyword=value's on one line per keyword.
• -h — Flag that causes the keyword names to be printed at the top of columns. Column headings, but make it fashion. 📋
• -n — Number of decimal places in numeric output.
• -o — ORs the conditions instead of ANDing them.
• -p — Prints the full pathnames of files.
• -t — Flag that causes the output to be in tab-separated tables with keyword column headings. Spreadsheet-coded. 🍓
• -u — Always prints ___ if the keyword is not found, even if there's only one keyword in the search.
• -v — Prints output as <keyword>=<value>, one per line.

🌈 WEB PAGE 🌈

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

(go say hi, she's got lore 💜)

👑 AUTHOR 👑

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

and that's the whole page, bestie 🫶 this one dropped on 6 July 2001 as part of WCSTools, and yeah, it's a gethead(1) situation — General Commands Manual energy from start to finish. mwah 💖✨