xrtinstrmap -- Build the RAW intrument map for PC and WT modes.
USAGE
xrtinstrmap infile outfile [parameter=value ... ]
DESCRIPTION
'xrtinstrmap' creates an instrument map in raw coordinates for PC and WT modes.
The user can produce individual instrument maps for each CCD frame or for a
set of frames by setting the parameter 'nframe'. If 'nframe=0' an instrument map
is generated for consecutive frames separated by less than 100 seconds.
By setting the parameter 'checkattitude'="yes" when 'nframe'=0,
time dependent instrument maps are generated if, within a given set of consecutive
frames, the spacecraft attitude variations are larger than 2.4 arcsec (corresponding to
approximately 1 detector pixel).
The instrument maps are stored in different extensions of a FITS file.
For PC mode, each map includes all the known bad pixels/columns used to flag
the events during the processing and the hot and flickering pixels recognized by
'xrthotpix' task. For WT mode, only bad columns are considered.
All this information is read from the bad pixel extension
of the input event file. Also the Field of View of the instrument and the CCD
readout window size are taken into account to determine whether a pixel is exposed
or not during the considered time interval.
PARAMETERS
infile [file name]
Name of the input event FITS file with BADPIX and GTI extensions.
Unix-compressed files are allowed.
hdfile [file name]
Name of the input Housekeeping Header Packets FITS file.
outfile [file name]
Name of output instrument map file.
(fovfile = CALDB )[file name]
Name of input FOV file. If set to CALDB (default), use the file in the
Calibration Database
(nframe = 0) [integer]
Number of frames used to create instrument map
(checkattitude=no) [boolean]
If 'checkattitude'=yes and 'nframe'=0, checks pointing stability in the instrument map calculation.
(history=yes) [boolean]
If set to yes, write parameter values and other information in HISTORY blocks.
(clobber=no) [boolean]
If 'clobber'=yes and outfile=filename, the file with the same name
will be overwritten, if it exists.
(chatter = 2) [integer]
Chatter Level (min=0, max=5).
EXAMPLES
Calculate the instrument map for the Photon Counting mode event file
sw00106107000xpcw4po_cl.evt, and write the output in the
file 'outfile.img'.