NAME

taskname - performs a task on a FITS file

USAGE

taskname infile[ext][filters] outfile

DESCRIPTION

This task does the following things.
  1. item 1
  2. item 2

This is the second paragraph of the description.

PARAMETERS

infile [filename]
Input file name and optional extension name or number enclosed in square brackets (e.g., 'infile.fits[0]' or infile.fits[events]'). Additional filter specifiers can be appended to the file name, also enclosed in square brackets, as shown in the examples.

outfile [filename]
Output file name. Precede it with an exclamation point, !, (or \! on the Unix command line) to overwrite a preexisting file with the same name (or set the clobber parameter to YES).

(clobber = NO) [boolean]
If outfile already exists, then "clobber = yes" will overwrite it.

(chatter = 1) [integer, 0 - 5]
Controls the amount of informative text written to standard output. Setting chatter = 5 will produce detailed diagnostic output, otherwise this task normally does not write any output.

(history = NO) [boolean]
If history = YES, then a set of HISTORY keywords will be written to the header of the output file to record the current value of all the task parameters.

EXAMPLES

Note that when commands are issued on the Unix command line, strings containing special characters such as '[' or ']' must be enclosed in single or double quotes.

1. This is the first example which illustrates how to perform a typical operation.

      taskname 'infile.fits[1]' outfile.fits
2. This is the 2nd example which illustrates a more complicated type of operation.

      taskname 'infile.fits[1]' outfile.fits clobber = YES
               chatter=5 history = YES

SEE ALSO

task1, task2,

LAST MODIFIED

MONTH 2002