XMM-Newton Science Analysis System


timeappend (timeappend-1.6) [xmmsas_20230412_1735-21.0.0]

Description

Applies a TIME column to a table specified by the parameter table. The time values are computed using OAL data through the C++ equivalent of the functions OAL_frameCounterToObt and OAL_obtToTimeTag.

This additional information will allow tasks such as tabgtigen to generate GTI data for ODF auxiliary files.

The TIME column is added to a copy of the original dataset. The name of the new dataset is specified through the parameter outset.

In order for this task to compute the times successfully, the following columns must be present in the table:

• FRAME column, of type 32-bit signed int
• CCDID column, of type 8-bit unsigned int

In the case of the PN instrument, an additional column is necessary:

• QUADRANT column, of type 8-bit unsigned int

In addition, if the OAL cannot be initialised by the input dataset, or if the user prefers to set explicit values, the instrument name, datamode and exposure number can be specified on the command line, by setting the parameter withsettings to true, and specifying the appropriate value for the instrument, datamode, node and expnr parameters.