NAME

       fitscopy - copy FITS files with optional filtering

SYNOPSIS

       fitscopy inputfile outputfile

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
              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

       Note that it may be necessary to enclose the input file name in  single  quote  characters  on  the  Unix
       command line.

SEE ALSO

       fpack(1), funpack(1).

CFITSIO version 3.370                              April 2014                                        fitscopy(1)