fitscopy(1)

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

💖 fitscopy — the bestie cut 💖

okay so this is fitscopy(1), filed under User Commands, and i am about to give you the full tour, no gatekeeping, no skimming, every single detail stays. 🫶

✨ NAME ✨

fitscopy — copy FITS files with optional filtering. that's it, that's the whole name. short king behavior. 💅

🌸 SYNOPSIS 🌸

fitscopy inputfile outputfile

🦋 DESCRIPTION 🦋

so basically: you copy an input file to an output file, and optionally you filter the file while that's happening. and like… the manpage calls it "seemingly simple" and honestly bestie that is the biggest understatement of the century because this thing can apply powerful filters that transform the input file as it is being copied. the way that it does all of this while your command line is literally just fitscopy inputfile outputfile?? main character energy fr fr. 👑

here's everything those filters can do:

  • extract a subimage from a larger image ✂️
  • select rows from a table
  • filter a table with a GTI time extension or a SAO region file
  • create or delete columns in a table
  • create an image by binning (histogramming) 2 table columns
  • convert IRAF format *.imh or raw binary data files into FITS images

that's the entire list, i did not skip a single one, no cap. 🧚

🔥 EXAMPLES 🔥

simple file copy

fitscopy in.fit out.fit

stdin to stdout

fitscopy - -

copy a subimage

fitscopy in.fit[11:50,21:60] out.fit

IRAF image to FITS

fitscopy iniraf.imh out.fit

raw array to FITS

fitscopy in.dat[i512,512] out.fit

copy rows with pi>35

fitscopy in.fit[events][pi>35] out.fit

bin an image

fitscopy in.fit[events][bin X,Y] out.fit

new x column

fitscopy in.fit[events][col x=.9*y] out.fit

time filter

fitscopy in.fit[events][gtifilter()] out.fit

spatial filter

fitscopy in.fit[2][regfilter("pow.reg")] out.fit
⚠️ okay important bestie, listen up: note that it may be necessary to enclose the input file name in single quote characters on the Unix command line. so like 'in.fit[...]' energy. do not get caught slippin with your shell eating your brackets. 😭💀

👑 SEE ALSO 👑

aaaand that's the whole page, every flag, every example, every warning, untouched and glowing. ✨ this was fitscopy(1) brought to you by CFITSIO version 3.370, dated April 2014 — vintage but still absolutely serving. now go copy something, bestie, you're gonna ate. 💜🎀🌈

📦 where this page comes from