FILENAME
to decide which format it is in.
If the keyword FILENAME
is missing or the first 4 characters of its
value are not one of the first 5 formats listed above, then the first 4
characters of the input FITS filename are checked. If these 4 characters
are not in the set (ccim, cier, cisp, cmap, cmos) the program attempts
to translate the file assuming a generic format (see GENERIC below).
.fits
'
or `.FITS
' or `.fit
' or `.FIT
'. If
that string is found, the base filename is truncated just before that
string. Then each filename is produced by appending a string of the
form `_0001.fits
' or `_0002.fits
' to the base
input filename, where the
integer is the row number. (see NOTE below about `row number').
If the -d option is used, the specified directory is prepended to
each output filename.
For example:
flcam cier08000212.fits.310 5 6
would produce 2 files named:
cier08000212_0005.fits
cier08000212_0006.fits
Additionally, when the input file is of CISP format the program
produces a second output FITS file containing the reset data as an image.
The filename of this second output contains the word `reset' after the
convention specified above is followed:
cisp26500136_reset_0010.fits
If the -short_header option is NOT selected,
arrays appearing in the data
are placed into the output header all with the same keyword. For
example, CISP format contains a two element array GPSCRPID
.
If the
2 values were 12 and 45, its appearance in the output file would look like:
GPSCRPID= 12 GPSCRPID= 45
ARRAY
, which must contain
values of type I (16-bit integers) or type J (32-bit integers). The
following keywords and values are used if present, otherwise the values default
as shown:
BITPIX 16 for ARRAY type I, 32 for type J NAXIS 2 NAXIS1 32 NAXIS2 32Note: the -cube option in not available for generic format.
flcam cier08000212.fits.310 5 6
would produce 2 output files, from rows 5 and 6 of the input file.
Another example: If only the 5th row is desired, the number 5 should be used for both the beginning_index and the ending_index:
flcam cier08000212.fits.310 5 5
INDEX
appears in the input file, then
the value of that
index is checked against the `row number'. If INDEX
does not match the `row number', a warning message is issued (unless
the program was invoked with the -quiet option).