fitscopy --version (return code: 0)
Usage: fitscopy inputfile outputfile
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.
See the CFITSIO User's Guide for a complete description of
the Extended File Name filtering syntax.
Examples:
fitscopy in.fit out.fit (simple file copy)
fitscopy - - (stdin to stdout)
fitscopy in.fit[11:50,21:60] out.fit (copy a subimage)
fitscopy iniraf.imh out.fit (IRAF image to FITS)
fitscopy in.dat[i512,512] out.fit (raw array to FITS)
fitscopy in.fit[events][pi>35] out.fit (copy rows with pi>35)
fitscopy in.fit[events][bin X,Y] out.fit (bin an image)
fitscopy in.fit[events][col x=.9*y] out.fit (new x column)
fitscopy in.fit[events][gtifilter()] out.fit (time filter)
fitscopy in.fit[2][regfilter("pow.reg")] out.fit (spatial filter)
Note that it may be necessary to enclose the input file name
in single quote characters on the Unix command line.
fitscopy --help (return code: 0)
Usage: fitscopy inputfile outputfile
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.
See the CFITSIO User's Guide for a complete description of
the Extended File Name filtering syntax.
Examples:
fitscopy in.fit out.fit (simple file copy)
fitscopy - - (stdin to stdout)
fitscopy in.fit[11:50,21:60] out.fit (copy a subimage)
fitscopy iniraf.imh out.fit (IRAF image to FITS)
fitscopy in.dat[i512,512] out.fit (raw array to FITS)
fitscopy in.fit[events][pi>35] out.fit (copy rows with pi>35)
fitscopy in.fit[events][bin X,Y] out.fit (bin an image)
fitscopy in.fit[events][col x=.9*y] out.fit (new x column)
fitscopy in.fit[events][gtifilter()] out.fit (time filter)
fitscopy in.fit[2][regfilter("pow.reg")] out.fit (spatial filter)
Note that it may be necessary to enclose the input file name
in single quote characters on the Unix command line.