NAME

xrttdrss2 -- Process XRT TDRSS Images and Photon Counting Mode messages.

USAGE

xrttdrss2 imfile pcfile [parameter =< value >]

DESCRIPTION

This routine processes some of the XRT TDRSS products generated after a Swift automatic slew on a new GRB detected. The products are: a) All the exposures (up to three) in Image mode taken by XRT after the slew to a new GRB. These images are used to calculate an on-board centroid and generate a postage stamp. b) The PC mode single pixel events of the first snapshot taken when a new GRB is acquired as automatic target.

IMAGES:

The processing applied to each image includes: flagging of the bad pixels and calibration sources, subtracting the bias if necessary and transforming the images from RAW to SKY. The RAW to SKY transformation uses the attitude information stored as an extension of the image. The attitude is derived from the Image packed header also stored as a separate extension in the image file.

PHOTON COUNTING:

The processing applied to the events includes: flagging of the bad pixels and calibration sources recorded in the STATUS column, calculating the values for the DETX/Y and X/Y columns and cleaning the bad events. The attitude information to derive the X and Y position is stored as an extension of the event file. This is derived from the PC mode packed header also stored as a separate extension in the event file.

PARAMETERS

imfile [file name]
Name of the input TDRSS image file. Type 'NONE' to not process the image file. It is expected the file to be uncompressed.

pcfile [file name]
Name of the input TDRSS photon counting file. Type 'NONE' to not process the image file. It is expected the file to be uncompressed.

attfile [file name]
Name of the input attitude file. Type 'NONE' to use attitude information in the input file (extension ATTITUDE).

(outimfile) [file name]
Name of the output TDRSS image file. Type DEFAULT to use standard naming convention

(outpcfile) [file name]
Name of the output TDRSS Photon Counting file. Type DEFAULT to use standard naming convention

(cleanbp=yes) [boolean]
Clean input files for bad pixels. If this flag is set to yes, the event file have the bad pixels removed.

(subimbias=no) [boolean]
Subtract bias from image input file? If set to 'yes', the task subtracts the bias value stored in CALDB only if non subtracted on-board.

(maxtemp=0.0) [real]
Temperature threshold to flag burned spot

(method=AREA) [string]
Image transform method (enumlist=[AREA|CENTER|EVENTS|INTENSITY|DEFAULT])

(teldef) [file name]
Name of the telescope definition file or CALDB

(cleanup=no) [boolean]
If 'cleanup'=yes the temporary file will be deleted

(interpolation=CONSTANT) [boolean]
Attitude interpolation method

(clobber=no) [boolean]
If 'clobber'=yes and outfile=filename, the file with the same name will be overwritten if it exists.

(history=yes) [boolean]
If setto'yes', write parameter values and other information in HISTORY keywords.

(chatter = 3) [integer]
Chatter Level (min=0, max=5)

EXAMPLES

  1. Process XRT TDRSS Image mode message xrt_raw_threshpix.fits and generates the output file image_out.img: 

    xrttdrss2 outimfile=image_out.img chatter=5 
          imfile=xrt_raw_threshpix.fits pcfile=NONE

BUGS

SEE ALSO

LAST MODIFIED

March 2006