GTI: Good Time Interval
Each Chandra event file contains one or more auxiliary blocks which include the good time intervals. In the case of ACIS, there is one GTI per CCD used in the observation. GTIs are table of sorted START and STOP times in units of seconds. For pipeline-produced data, the GTIs give the time periods when the mission time line parameters fell within acceptable ranges; see the MTL dictionary entry for more information. Additional temporal filtering by the user - such as to remove background flare events - can further restrict these periods. The data subspace lists the GTI filters that have been applied to a file; see the subspace dictionary entry.
The GTIs for pipeline-produced ACIS data are computed in two stages.
The tool acis_build_chip_gti is used to compute the initial set of GTIs for each CCD that is active during an observation. These GTIs include the entire duration of an observation. Only frames that are identified as having been dropped are excluded from the GTIs. The START and STOP times for each GTI are aligned with the start and stop times of the corresponding frame of data. The START and STOP times for a given frame can differ from one CCD to another because the read-out times of the CCDs may be staggered. The GTIs may also differ from CCD to CCD because a frame of data may be dropped for one CCD, but not another. The output GTIs are appended to a Level=1 ACIS event-data file. One FITS extension is appended for each active CCD.
A refined set of GTIs is obtained by using the file mtl1.fits and the tool mtl_build_gti. The set of criteria used by mtl_build_gti is defined by the GTI limit file in the CALDB. These criteria may include (but are not limited to)
- The first one or two frames, which do not contain useful science data,
- The quality and type of the aspect solution,
- Gaps in the aspect solution,
- The motion of the optical axis,
- The angles between the optical axis and the limb of the Sun, the limb of the Earth, the limb of the Moon, and the direction of motion of the spacecraft,
- The temperatures of various portions of the telescope and the optical bench,
- The number of events telemetered relative to the number of threshold crossings, and
- The reaction-wheel speed.
The union of these GTIs and the GTIs produced by acis_build_chip_gti are used to produce the file flt1.fits with the tool acis_merge_gti. The file flt1.fits has a separate extension for each active CCD. Since the START and STOP times produced by the tool mtl_build_gti are not necessarily aligned with the start and stop times of a frame, the GTIs in the file flt1.fits may have START and STOP times that occur in the middle of a frame. This misalignment means the actual exposure for a CCD can differ from the value recorded in the exposure keyword for the CCD. The value in the keyword is based on the sum of the GTIs (i.e. may contain partial frames). However, the actual exposure for a timed-exposure mode observation contains only full frames. When the data are filtered using the GTIs in the file flt1.fits, either all or none of the events are copied to the file evt2.fits because all of the events in a single frame for a CCD are assigned the same time. The difference between the actual and effective exposures should be negligible except in the very rare case where a significant fraction of the frames have GTIs with START or STOP times in the middle of the frame. Users can align the GTIs to the ACIS exposure frame time boundaries using the gti_align script.
Users can customize their GTIs by using the tool dmgti. There is a basic example of how to use dmgti in the Making Images & Filtering Data with the Data Model thread.
ACIS users may also want to consider the effects of warm focal plane temperatures on their analysis and further time filter the data.
If users need to create different GTIs for separate chips then the multi_chip_gti script can be used to merge them together to create a single GTI file that can be used to filter the event file.