51 lines
1.5 KiB
Groff
51 lines
1.5 KiB
Groff
.TH fitscopy "1" "April 2014" "CFITSIO version 3.370" "User Commands"
|
|
.SH NAME
|
|
fitscopy \- copy FITS files with optional filtering
|
|
.SH SYNOPSIS
|
|
.B fitscopy \fIinputfile\fR \fIoutputfile\fR
|
|
.SH 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.
|
|
.SH EXAMPLES
|
|
.TP
|
|
simple file copy
|
|
.B fitscopy in.fit out.fit
|
|
.TP
|
|
stdin to stdout
|
|
.B fitscopy \- \-
|
|
.TP
|
|
copy a subimage
|
|
.B fitscopy in.fit[11:50,21:60] out.fit
|
|
.TP
|
|
IRAF image to FITS
|
|
.B fitscopy iniraf.imh out.fit
|
|
.TP
|
|
raw array to FITS
|
|
.B fitscopy in.dat[i512,512] out.fit
|
|
.TP
|
|
copy rows with pi>35
|
|
.B fitscopy in.fit[events][pi>35] out.fit
|
|
.TP
|
|
bin an image
|
|
.B fitscopy in.fit[events][bin X,Y] out.fit
|
|
.TP
|
|
new x column
|
|
.B fitscopy in.fit[events][col x=.9*y] out.fit
|
|
.TP
|
|
time filter
|
|
.B fitscopy in.fit[events][gtifilter()] out.fit
|
|
.TP
|
|
spatial filter
|
|
.B fitscopy in.fit[2][regfilter("pow.reg")] out.fit
|
|
.PP
|
|
Note that it may be necessary to enclose the input file name
|
|
in single quote characters on the Unix command line.
|
|
.SH "SEE ALSO"
|
|
\fBfpack\fP(1), \fBfunpack\fP(1).
|