NAME

sximodegti - Create GTI excluding dead time for each Hitomi SXI observing mode

USAGE

sximodegti infile outfile mergefile tstart tstop

DESCRIPTION

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.

PARAMETERS

infile = sxi_in.evt [filename]
Input SXI exposure file.

outfile = sxi_out.gti [filename]
Output GTI file. This file has one extension per combination of DATACLASS, CCD_ID, and SEGMENT.

mergefile = sxi_mg.gti [file]
Output GTI file with merged dataclasses. This file has one extension per DATACLASS.

tstart = 0.0 [double]
Start time [s] for pointed observations. If the TSTART of 'infile' is later than this value, TSTART is used instead.

tstop = 0.0 [double]
Stop time [s] for pointed observations. If the TSTOP of 'infile' is earlier than this value, TSTOP is used instead.

(numdclass = 0) [integer]
Output: Total number of dataclasses found.

(cleanup = yes) [boolean yes|no]
Delete temporary files.

(clobber = no) [boolean yes|no]
Overwrites the existing output file if set to yes.

(chatter = 2) [integer 0|1|2|3]
Chatter level for output. Set to 0 to suppress output, or to 1, 2, or 3 for increasing the chatter of the output.

(logfile = !DEFAULT) [string DEFAULT|NONE|file name]
Log file name. If set to DEFAULT, uses the name of the task and, if preceded by "!", overwrites the file if it exists. If set to NONE, no log file is created.

(debug = no) [boolean yes|no]
Diagnostic output is printed to the screen if set to yes.

(history = yes) [boolean yes|no]
Records task parameters in HISTORY.

EXAMPLES

  1. Run sximodegti with default parameters.
       sximodegti infile=ah00050733sxi_a0exp.fits.gz outfile=ah000507033sxi_mode.gti.gz mergefile=ah000507033sxi_seg.gti.gz \
          tstart=47390384. tstop=47430516.
    

SEE ALSO

sxiphas, sxiflagpix, sxipi, mgtime

LAST MODIFIED

November 1, 2023