dfits(1)

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

💫 dfits — the manual, but make it cute 💫

okay bestie, so this is the page for dfits, a General Commands Manual girly, and she is literally here to show you FITS file header info. no cap. let's get into it 🎀

✨ NAME ✨

dfits — display FITS file header information 🦋

✨ SYNOPSIS ✨

dfits [-x xtnum] <list>
dfits [-x xtnum] -

that's the whole vibe. two ways in, one flag, we love a minimalist queen 👑

✨ DESCRIPTION ✨

so like. dfits displays FITS header informations on stdout. yes bestie, "informations". we don't gatekeep grammar here 💅

where can that header info live? options, babe:

  • in the main header only — this is the default, the main character energy 🫶
  • in extensions 📦
  • or in both, because why choose 🌈

(see the -x option below for how to pick, iykyk)

and dfits accepts multi-file input — feed her a whole list, she eats 🔥

dfits - expects single file data coming from stdin. just one file, one vibe, through the pipe.

ALSO — and this is new, so pay attention — dfits now also accepts HDR files. how does she know they're HDR files? iconic detective work: they're identified from the fact that they contain a line feed in one of the 80 first characters. that's the tell. slay 🔍

✨ OPTIONS ✨

  • -x xtnum — Specifies the extension to print out. Extensions are numbered starting from 1. If this option is not specified, only the main header is printed out. If this option specifies an extension that does not exist, nothing is printed out. 💀 Specify 0 as extension number to get a print of the main header plus all extension headers. zero is the "give me everything" girlie, obsessed 😌

🌸 Examples 🌸

dfits *.fits
dfits *.fits | grep NAXIS3
gzip -d < star.fits.gz | dfits - | more
dfits -x 0 *.fits
dfits -x 3 *.fits

look at her go. pipe her, grep her, gunzip her, she's fine with all of it ✨

✨ SEE ALSO ✨

fitsort can be combined with dfits output to sort out keyword values of a group of FITS files. bestie duo fr fr 🤝

✨ FILES ✨

Files shall all comply with FITS format. non-negotiable, no exceptions, that's the rule 💖

okay so real talk — if you ask for an extension that doesn't exist, you get absolutely nothing printed. not an error, not a hint, just silence. dramatic? yes. accurate? also yes. 🫶

and that's the whole page, bestie!! this icon dropped on 30 Mar 2000 and she's still serving dfits(1) energy to this very day. periodt. 💅✨🎀

📦 where this page comes from