fitscopy - copy FITS files with optional filtering
Contents
Description
Copy an input file to an output file, optionally filtering the file in the process. This seemingly simple
program can apply powerful filters which transform the input file as it is being copied. Filters may be
used to 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, and convert IRAF format *.imh or raw binary data files into FITS images.
Examples
simple file copy
fitscopyin.fitout.fit
stdin to stdout
fitscopy--
copy a subimage
fitscopyin.fit[11:50,21:60]out.fit
IRAF image to FITS
fitscopyiniraf.imhout.fit
raw array to FITS
fitscopyin.dat[i512,512]out.fit
copy rows with pi>35
fitscopyin.fit[events][pi>35]out.fit
bin an image
fitscopyin.fit[events][binX,Y]out.fit
new x column
fitscopyin.fit[events][colx=.9*y]out.fit
time filter
fitscopyin.fit[events][gtifilter()]out.fit
spatial filter
fitscopyin.fit[2][regfilter("pow.reg")]out.fit
Note that it may be necessary to enclose the input file name in single quote characters on the Unix
command line.
Name
fitscopy - copy FITS files with optional filtering
See Also
fpack(1), funpack(1). CFITSIO version 3.370 April 2014 fitscopy(1)
Synopsis
fitscopyinputfileoutputfile
