NAME
uvotimggen - create a multi-extensioned fits image file for each uvot
filter from a singe fits image and a observing sequence text file.
USAGE
uvotimggen infile extfile obsid starttime Btime Brawx Brawy rate0
clobber history chatter mode
DESCRIPTION
This program takes a image file as a seed and generate several multi
extensioned fits file based on input from a observing sequence text
file. (One fits file will be created for each uvot filter.)
uvotimggen will allow the user to
- specify an fits image
- specify an observing sequence to generate images for
PARAMETERS
- infile [filename]
- Image file to use a seed to generate other images from
- extlist [filename]
- obserbing sequence table in text file format
- obsid [string]
- An observation id used to create the output file names
- starttime [integer]
- number of seconds after the burst the first image occurs
- Btime [string]
- The time you want the burst to occur
- Brawx [integer]
- raw x coordinates of burst
- Brawy [integer]
- raw y coordinates of burst
- (clobber = no) [boolean]
- If outfile already exists, then "clobber = yes" will overwrite it.
- (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 value of all the ftcopy
task parameters that were used to produce the output file.
- (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.
- (mode = ql) [string, ql|h]
- If mode = ql then .
If mode = h then .
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.
The following example is a typical uvotimggen run.
uvotimggen "INPUT.FIT" "OBSERVE.LIST" "012345678001" 10 default 1024 1024 0.5
Where INPUT.FIT is the name of a fits image to use as a seed.
OBSERVE.LIST is a text table containing observing sequences, and
INPUT.FIT is the name of a fits image to use as a seed.
- 012345678001 is an observation id
- 10 is the number of seconds after the burst the first image generated will occur
- default is the time the burst will occur (get from the input image file)
- 1024 raw x coordinate of burst
- 1024 raw y coordinate of burst
- 0.5 is the intensity of the burst image
Alternatively the user could just run uvotimggen and be prompted for the
inputs
LAST MODIFIED
November 2003