XMM-Newton Science Analysis System


hkgtigen (hkgtigen-1.15) [xmmsas_20230412_1735-21.0.0]

Diagnostic mode

The task possesses a diagnostic mode (see parameter diagnosticmode) which facilitates a more detailed analysis of the individual HK parameter validity intervals. In this mode, in addition to the global GTI, each individual HK parameter selection expression is used to construct a corresponding GTI table which contributes to the global one. All GTI tables will be generated in a single data set named via the gtiset task parameter. The table names are be STDGTI (total) and STDGTI-hkname (individual) respectively. The individual GTI tables contain the corresponding selection expressions in an attribute EXPR.

In cases where the total sum of the global GTIs is only a small fraction of the observing time the individual GTIs can be used to pinpoint the most limiting parameter(s). To aid this diagnosis further the individual GTIs together with the global ones can be visualized using task dsplot (see parameter plotgtis) and an ASCII diagnostic output file is generated (see parameter diagfile). The contents is formed by a two-column table - the first column gives the HK parameter name and the second column the fraction of the total observing time that this parameter is out of valid limits. Lines starting with # are comments and should be ignored.