XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


hkgtigen (hkgtigen-1.15) [xmmsas_20230412_1735-21.0.0]

Parameters

This section documents the parameters recognized by this task (if any).

ParameterMand Type Default Constraints
instrumentyesstringemos1xmm$\vert$emos1$\vert$emos2$\vert$epn$\vert$rgs1$\vert$rgs2$\vert$om
This determines the instrument for which the GTI data set is to be generated.
 
withparametersnobooleanfalsetrue$\vert$false
A boolean switch determining whether the list of to be considered HK parameters shall be explicitly specified with parameter parameters. If set to false, all parameters for which entries exists in the CCF file HKParmInt are considered in the GTI data set generation.
 
parametersnostring list“”blank separated list of HK parameter names
If withparameters is set to true only the HK parameters given in the list will be considered in the generation of the final GTI data set. The parameter names must be given in their long form.
 
exceptnobooleanfalsetrue$\vert$false
If set to true and withparameters is set to true all HK parameters for which there are entries in the CCF file HKParmInt are considered in the GTI set generation except for those explicitly listed in parameters.
 
withoverrideparametersnobooleanfalsetrue$\vert$false
If set to true overrideparameters must contain a list of HK parameter names and overrideparametervalues a corresponding list of validity ranges for those parameters (see below).
 
overrideparametersnostring list“”blank separated list of HK parameter names
If withoverrideparameters is set to true the list must contain valid HK parameter names. For each parameter there must be a corresponding value (i.e., validity range expression) specified in parameter overrideparametervalues. This value replaces the one from the CCF HKParmInt constituent for that HK parameter if an entry exists at all. Otherwise the value simply supplements the other validity ranges assembled so far. The parameter names must be given in their long form. If supplemental parameter names are to be given for which no long names are defined in the CCF constituent HKParmInt the corresponding short names can be used instead.
 
overrideparametervaluesnostring list“”;-separated list of validity range expressions
This is the list of validity range expressions corresponding to the parameter names in overrideparameters. List items must be separated with the character ';' and each item must be a valid boolean selection expression as detailed in the documentation of package selectlib. The expression may contain the character '@' which will get replaced with the name of the corresponding HK parameter.
 
withgtisetnobooleantruetrue$\vert$false
Boolean switch determining whether or not a GTI set should be generated. If set to false, for each exposure and applicable periodic HK file hkgtigen will print on stdout the command line with which tabgtigen will be invoked.
 
gtisetnostringgti.dsname of non-existing data set
The name of the GTI data set to create.
 
timecolumnnostringTIMEname of existing column in HK file
Duplicates the parameter with the same name of task tabgtigen
 
prefractionnoreal0.5 $0<={\tt prefraction}<=1$
Duplicates the parameter with the same name of task tabgtigen
 
postfractionnoreal0.5 $0<={\tt postfraction}<=1$
Duplicates the parameter with the same name of task tabgtigen
 
diagnosticmodenobooleanfalsetrue$\vert$false
If set to true the task's diagnostic mode is entered.
 
diagfilenostringSTDOUT 
The name of the ASCII diagnostic file to be generated in diagnostic mode. The special value STDOUT is recognized as the standard output channel.
 
plotgtisnobooleanfalsetrue$\vert$false
If set to true dsplot is invoked at the end to visualize the individual GTIs together with the total ones.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16