FIHEADER(1)

📦 version 0.9.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 FIHEADER — the manual, but make it cute 💖

okay bestie, welcome to fiheader(1), a user command that is genuinely iconic and also lowkey a whole personality. let's get into it 🫶

✨ NAME ✨

fiheader — reading and manipulating FITS header keywords. that's the whole vibe. reading them, setting them, altering them, deleting them. main character energy fr fr 👑

🌈 SYNOPSIS 🌈

fiheader [opions] [input] [-o|--output <output>]

(and yes, the typo in [opions] is literally in the original, so we are keeping it exactly as it is. not me fixing it. never that. 💅)

🦋 DESCRIPTION 🦋

so here's the tea: this program lets you read, set, alter or remove a whole set of values that are associated with whatever keywords you specify — and it does all of that in the primary header unit of a FITS image file. that's the header, bestie, the plain old header. no cap. 🎀

🌸 OPTIONS 🌸

💜 General options:

  • -h, --help — gives you a general summary about the command line options. the quick lil recap, yk?
  • --long-help, --help-long — gives you a detailed list of command line options. the deluxe version.
  • --wiki-help, --help-wiki, --mediawiki-help, --help-mediawiki — gives you a detailed list of command line options, but formatted in Mediawiki format. wiki girlies rise up ✨
  • --version, --version-short, --short-version — gives you some version information about the program. the who-am-i check 💫
  • -i, --input <image file> — the name of the input FITS image file.
  • -o, --output <image file> — the name of the output FITS image file. and yes, it can be the same as the input image file, she contains multitudes 💖

🍓 Read keyword values:

  • -g, --get, --read <keyword>,... — the list of keywords to get from the FITS header. a lil shopping list of keywords 🛍️
  • -F, --format <format> — the format of the output. it's a space separated list of the arguments "filename", "keyword", "value", "comment" or "list", in whatever order you want them. and the "list" here? it's a list of tab-separated values of matched keywords. slay, customisable 😌
  • -x, --extension <extension> — read keyword values from the given extension. going deeper, bestie 🌊
note that shell wildcard character patterns can be used in the keyword specifications. so go wild with the wildcards, she supports it 🌈

👑 Altering FITS headers:

  • -s, --set, --update <keyword>=<value>[/<comment>],... — list of keywords with their new values (and optional comments) to be altered. glow-up time 💅
  • -a, --append <keyword>=<value>[/<comment>],... — list of keywords with their new values (and optional comments) to be appended to the existing list of keywords. adding to the roster, not replacing it 🫶
  • -d, --delete <keyword>,... — list of keywords to be removed from the header. she's gone, bye 💀
  • --force-alter-reserved-keywords — enable this to alter reserved FITS keywords. ⚠️ use with caution — these are reserved for a reason bestie, don't be reckless with the crown jewels 👑😭
  • -w, --rewrite — re-write the input file(s) directly. and listen: use this option exclusively from -o|--output. pick a lane, not both 🚫

😭 REPORTING BUGS 😭

found a bug? report bugs to <apal@szofi.net>, and see also https://fitsh.net/. tell them everything, they wanna know 🐛💌

Copyright © 1996, 2002, 2004-2008, 2010-2016, 2018-2020; Pal, Andras <apal@szofi.net>

and that's the whole page, bestie!! this was fiheader version 0.9.4, dated 2021.01.24, and the page itself is from January 2021 — shoutout to the fiheader 0.9.4 (2021.01.24) era, we love her, periodt 💖✨

📦 where this page comes from