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

rmfgen (rmfgen-2.8.5) [xmmsas_20211130_0941-20.0.0]


This section documents warnings and errors generated by this task (if any). Note that warnings and errors can also be generated in the SAS infrastructure libraries, in which case they would not be documented here. Refer to the index of all errors and warnings available in the HTML version of the SAS documentation.

 The channel range specified by the TLMIN and TLMAX attributes of the column CHANNEL differs from the intrinsic channel range of the response data. If the spectral channel range is greater than the response range, rmfgen will pad out the response to fit the spectral range. If the spectrum contains channels that are a subset of the response range, rmfgen will truncate the response data to match the channel range.
corrective action: Pad out or truncate response data to match channel bounds specified in spectral dataset.
 The program reads the energy boundaries of the spectral channels from the CAL and attempts to rebin these boundaries to the number of bins in the input spectrum. If the ratio of spectral bins to CAL channel boundaries is not an integer the rebinning is not possible and so the boundaries are defined as a regularly increasing set of energies.
corrective action: assume that the channel energies are regularly spaced.
 The PN rmf generator is dependent on the observing mode. If this is not available from the input spectrum or is not recognised then the task defaults to using full frame mode.
corrective action: Use PRIME_FULL_WINDOW mode
 The RMF generated is dependent on the event patterns used to create the spectrum. If these can not be read from the DSS in the spectrum header then the task assumes that all patterns have been used.
corrective action: Assume all patterns selected
  The TLMIN attribute value for column CHANNEL is not zero
  The values of attributes TLMIN and TLMAX for column CHANNEL and attribute DETCHANS are not such that $\rm DETCHANS \leq TLMAX-TLMIN + 1$.
  The channel offset specified by attributes SPECPIX, SPECVAL and SPECDELT does not correspond to an integer value.
  If withenergyranges is set to true, and responsedata is set to `cal', then this error is raised if the requested range specified by parameters energymin and energymax is outside the range over which response data is defined in the CAL.
  rmfgen is supposed to pad out/truncate the response data to match the spectral channel range. This error is raised if this particular algorithm fails. An SPR should be raised.
  Prior to regrouping, no detector channels could be found in the response matrix above the threshold level specified by the threshold parameter. This error is raised at a different point in the grouping algorithm to the error noGroups below - such an err
  No groups of contiguous response elements above threshold could be found in the response matrix, although the maximum number of PI elements found in any one channel is greater than one. This suggests a problem with the grouping algorithm, and an SPR should be raised.
  There are less than 2 data points in the dataset specified by the parameter photondistset (and modelpileup is set to true).
  The spectrum contains too many data channels. The EPIC calibration is defined for a certain PI channel binning. If this is exceeded then the task can not produced a meaningful matrix. Please recreate the spectrum using the standard number of channels or less. The current standard is 800 MOS bins from PI channels 0 to 11999 and 4096 PN bins from 0 to 20479.
  The patterns in the datra subspace are not the standard selections. See the XMM SAS User Guide for more information about the supported patterns.
  Literally means an incorrect treatment of the CCF within the task. It can probably only arise if the REDIST CCF being used is corrupt.
  The raw event file, containing all the charges recorded in the CCD where the source is centred, does not have the expected format. See section3.9 for details of how to create the file.
  The input spectrum has been created using a different channel range to the one recommended. As the response function is normalised over the channels contained in the input spectrum this will lead to an incorrect RMF which is likely to give wrong spectral fit results. The task can be forced to produce an RMF anyway by setting the parameter acceptchanrange=yes .

For other warnings and errors please see the arfgen user guide.

XMM-Newton SOC -- 2021-11-30