The task sximodegti is a Perl script that creates a good time interval (GTI) for each supported SXI mode (full window, 1/8 window, full window+burst, 1/8 window+burst, 1/8 window+area discrimination, and the full window+0.1 sec burst used for the Crab). These GTI are used for exposure map generation. The task reads as input the exposure FFF file and creates GTI for all modes found.
The SXI exposure file for an observation contains rows of exposure packets that correspond to a 3x3 and 5x5 event packet (contained separately in the event list). Each CCD and segment combination is contained in one row in the exposure file, therefore there should be 8 rows per time stamp in this file. However, the file contains information for all modes run during the observation, including different DATACLASS (operating configuration) and whether diagnostic full-frame data were obtained along with the science event data. Only some of these configurations are supported for science data. The sximodegti script reads the exposure file and creates a GTI extension for each combination of CCD_ID, SEGMENT, and supported science mode, keeping track of the total number of frames for proper calculation of the exposure time.
There are two output files whose names are set by the parameters 'outfile' and 'mergefile'. The first output ('outfile') contains a GTI extension for each DATACLASS and frame. Each extension contains START, STOP, and frame number (FRAMENUM) columns. The task also checks if a CCD_ID+SEGMENT combination is missing, or appears more than once. The information is output to the 'logfile' of the task. The second output ('mergefile') contains a GTI extension per DATACLASS, where GTI for different CCD_ID+SEGMENT combinations are merged into one (using a logical AND). The number of unique DATACLASS values is also output to the parameter 'numdclass'.
Only times within the range specified by the 'tstart' and 'tstop' parameters are included in the output GTI. Normally, these are the start and stop times of pointed observations that exclude the slew data. If the parameters 'tstart' or 'tstop' are outside of the range covered by the exposure file, the file TSTART or TSTOP header keywords are used instead.
sximodegti infile=ah00050733sxi_a0exp.fits.gz outfile=ah000507033sxi_mode.gti.gz mergefile=ah000507033sxi_seg.gti.gz \ tstart=47390384. tstop=47430516.
sxiphas, sxiflagpix, sxipi, mgtime
November 1, 2023