NAME

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

  1. Calculate the instrument map for the Photon Counting mode event file sw00106107000xpcw4po_cl.evt, and write the output in the file 'outfile.img'.

     > xrtinstrmap infile=sw00106107000xpcw4po_cl.evt outfile=outfile.img
       hdfile=sw00106107000xhdtc.hk

BUGS

SEE ALSO

LAST MODIFIED

May 2007