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


rgsrmfgen (rgsrmfgen-1.17) [xmmsas_20230412_1735-21.0.0]

Parameters

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

ParameterMand Type Default Constraints
 
In general for this task only one filename need be provided and the rest are inferred by default using the provided filename as a template. The rules governing this behavior are intended to follow what the user would instinctively expect and as a result are somewhat complicated. The descriptions below focus on the meaning of each filename parameter, leaving the exact details of the inferred default value to be explained in the algorithm section.  
evlistnodataset  
The filtered event list. It must contain the EVENTS table and exposure map extensions. Not modified. The default value infers the EVENLI file.
 
srclistnodataset  
The source description list. It must contain the SOURCES table and the relevant selection region extensions. Not modified. The default value infers the SRCLI_ file.
 
rmfsetnofile  
The response matrix file (OGIP-compliant format). Either created or modified depending on parameter newrmf. When modifying an existing response matrix (newrmf=no) an explicit value for this filename must be provided, which then becomes the template from which other filenames may be inferred. For a new response matrix the default value infers the RSPMAT file.
 
witharffilenobooleanno 
Switch to enable the creation of two independent response files ARF and RMF.
 
arfsetnofile  
The ARF file name (OGUP-compliant format).
 
emaxnoreal2.8non-negative
When creating a new response matrix (newrmf=yes), this is the upper edge of the highest incident-energy bin to be included. When overwriting part of an existing matrix (newrmf=no), this identifies the upper incident-energy bin in the interval to be recomputed. This value will be raised automatically as necessary to maintain the contiguity of the bins, and can be used to extend the range of the existing matrix.
 
eminnoreal0.3non-negative
When creating a new response matrix (newrmf=yes), this is the lower edge of the lowest incident-energy bin to be included. When overwriting part of an existing matrix (newrmf=no), this identifies the lower incident-energy bin in the interval to be recomputed. This value will be lowered automatically as necessary to maintain the contiguity of the bins, and can be used to extend the range of the existing matrix.
 
rowsnointeger4000positive
The number of incident-energy bins to cover the range from emin to emax. Typically, when overwriting part of an existing matrix (newrmf=no), the intention is to increase the resolution of the matrix over a small interval. This can yield a matrix of manageable size that has very high resolution in just the right places.
 
fftdimnointeger31-5
The wings of the various distributions that are convolved together to form the narrow features of the line-spread function are truncated to limit the size of the convolution space. An increment of one in this parameter doubles the size of the convolution space; the larger the convolution space, the slower the computation and the less power is lost to the truncation.
 
newrmfnobooleanyes 
Whether to create a new response matrix or edit an existing one.
 
 
The remaining parameters apply only when newrmf=yes. When editing an existing matrix these specifications are obtained from its contents.  
withspectrumnobooleanyes 
Determines how various details of the response matrix are specified. On true: enables parameter spectrumset, and the response matrix is made compatible with this spectrum with respect to its source, order, background correction, and channel definitions. On false: enables parameters source, order, and bkgcorrect, while the channel definitions are obtained from the event list (parameter evlist). Note that a channel rebinning factor cannot be specified except through the spectrumset, an oversight which may be corrected in a future version.
 
spectrumsetnodatasetsrspec.ds 
A spectrum file produced by rgsspectrum from the data in the given event list (parameter evlist). Not modified. The metadata from this file are used to ensure that the response matrix produced is the suitable companion to this spectrum for the purpose of analysis. A default filename cannot be inferred; when this parameter is enabled (withspectrum=yes) an explicit value must be provided, which then becomes the template from which other filenames may be inferred.
 
sourcenointeger non-negative
If a spectrum file is not provided (withspectrum=no) this parameter specifies the INDEX number of a source in the source description list (parameter srclist), and thereby the incidence angle and selection regions for the response matrix. The default value, zero, indicates the SOURCEID attribute of the EVENTS table in the event list (parameter evlist), which is the source that was used to perform the aspect-drift corrections.
 
ordernointeger1positive
If a spectrum file is not provided (withspectrum=no) this parameter specifies the reflection order for computing the response matrix. In conjunction with the source parameter, this identifies the energy selection region from the source description list (parameter srclist). Although it does include the contribution of the LSF for every order, the final response matrix is nevertheless order-specific with respect to its effective area and EBOUNDS extension.
 
bkgcorrectnobooleanyes 
If a spectrum file is not provided (withspectrum=no) this parameter specifies whether background correction should be included in the response matrix computation. If yes, then the background selection region from the source description list (parameter srclist) is required. In HTR mode the background correction to the response matrix is not defined, and this parameter is quietly ignored.
 
withmirrorpsfnobooleanyes 
Whether to convolve the standard mirror PSF distribution into the LSF. This option should be used with care and knowledge. An appropriate circumstance for omitting the mirror PSF is when a custom angular distribution is provided (withangdist=yes) that empirically establishes the PSF contribution.
 
withangdistnobooleanno 
Whether to convolve a custom angular distribution into the LSF. This option should be used with care and knowledge. Enables parameter angdistset. Note that this distribution is one-dimensional, an arbitrary function of dispersion off-axis angle. It is rebinned onto the dispersion channel space according to the order and central incident energy of each LSF. The problem of reducing a two-dimensional image to this one-dimensional distribution is left to the user.
 
angdistsetnofileangdist.txt 
An ASCII file containing a one-dimensional angular distribution along the axis of dispersion in arc minutes. Not modified. Each line of the file describes a distribution bin in terms of the start and stop angles, and the value assigned to that bin. The distribution may be normalized to any value, though unity is expected and recommended. See the input files descriptions for further details.
 
dyneffarecorrnobooleanyes 
Enable the dynamic effective area correction based on Chebyshev polynomials.
 
withrectificationnobooleanno 
Use empirical RGS effective area correction
 
witheffectiveareacorrectionnobooleanno 
Use RGS effective area correction
 
spectrumbinningnochoicelambdalambda beta
Dispersion binning type.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16