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


rgssources (rgssources-6.3.3) [xmmsas_20230412_1735-21.0.0]

Errors

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.

noAttitudeerror 
 No attitude information is available from the oal for the start time of the exposure.
 
badAttitudeStyleerror 
 The value of attstyle was not recognized.
 
badFileModeerror 
 The value of filemode was not recognized.
 
nonUniqueEpicIderror 
 There is more than one source in the EPIC source list with a given ML_ID_SRC or BOX_ID_SRC number.
 
tooManyProposalserror 
 The RGS source list to be modified has more than one source with the label `PROPOSAL'.
 
noProposalerror 
 The RGS source list to be modified has no source with the label `PROPOSAL'.
 
tooManyAttSrcerror 
 The RGS source list to be modified has more than one source with the label `ONAXIS'.
 
noAttSrcerror 
 The RGS source list to be modified has no source with the label `ONAXIS'.
 
badEpicIdColumnerror 
 The supposed EPIC source list has neither a ML_ID_SRC or BOX_ID_SRC column.
 
emptyUserLabelerror 
 The label parameter, which is the desired label of the user-added source, is the empty string.
 
duplicateLabelerror 
 A candidate additional source has been found to have the same label as one of the existing sources. This error can only occur if the parameter clobberonlabel=no.
 
notSupportederror 
 A mode has been requested that is not yet implemented.
 
badPrimeStyleerror 
 The value of primestyle was not recognized.
 
unableToSetNullerror 
 For some reason it wasn't possible to set an integer 32 null value for the column EPIC_FILE.
 
unreliableResulterror 
 For some reason it failed to get the information about the proposed position from the ODF, probably because the ODF is incomplete or corrupt (or wrong). Although the output file is created, there is no guarantee for the contents.
 
badSrcFileTypeerror 
 The source list supplied to parameter srclist is not in a recognised format.
 
unknownInstrumenterror 
 No valid value was provided for the instexpid parameter, and rgssources was unable to deduce the instrument from the old-format file header or name.
 
notStandardFileNameerror 
 The task has attempted to deduce either the instrument or the exposure number from the file name, but the name was not found to adhere to either the PPS or rgsproc formats.
 
instIdClashwarning 
 The instrument recorded in the source list header keyword INSTRUME is not the same as that derived from the value of the instexpid parameter.
corrective action: The task uses the value from the source list header.
 
expIdStrClashwarning 
 The 4-character exposure identifier recorded in the source list header keyword EXPIDSTR is not the same as that derived from the value of the instexpid parameter.
corrective action: The task uses the value from the source list header.
 
mangledIdInstColumnwarning 
 In the input EPIC source list, a row that should contain a required instrument-ID is missing.
corrective action: No action.
 
mangledIdInstBandColumnwarning 
 The same as above, but in this case it also includes the case for the energy-band ID.
corrective action: No action.
 
noValidEpicSourceswarning 
 None of the epic sources have met all the conditions for inclusion.
corrective action: No epic sources are added to the file.
 
noEpicSourcesInFovwarning 
 None of the epic sources were found to lie within the field of view of the RGS camera.
corrective action: No epic sources are added to the file.
 
noEpicSourceswarning 
 There are no epic sources in the correct energy band.
corrective action: No epic sources are added to the file.
 
duplicateLabelwarning 
 A candidate additional source has been found to have the same label as one of the existing sources. If clobberonlabel=no, this condition causes the task to fail with an error.
corrective action: New source is not appended to the source list.
 
outsideFOVwarning 
 A source has been found to lie outside the field of view of the RGS camera.
corrective action: No action.
 
confSetAllZeroRatewarning 
 A set of confused sources has none with a positive value of RATE.
corrective action: All sources flagged as confused.
 
primeLabelNotFoundwarning 
 The user has set changeprime=yes and primestyle=`label', but no source with a label equal to primelabel has been found in the file.
corrective action: The prime source is set to point to the proposal source.
 
primeIndexNotFoundwarning 
 The user has requested that the prime source be set to a source of a particular index value, but no source in the list has this index value.
corrective action: The prime source is set to point to the proposal source.
 
noBrightPrimewarning 
 The user has requested that the prime source be set to the index of the brightest source, but brightest source has a rate less than or equal to zero.
corrective action: The prime source is set to point to the proposal source.
 
noChangePrimewarning 
 The user has set userasprime, but not changeprime.
corrective action: Prime source is not changed.
 
primeAtLabelDefaultwarning 
 The user has set changeprime=yes and primestyle=`label', but primelabel still has its default value. This may indicate that the user forgot to set it.
corrective action: No action.
 
primeAtIndexDefaultwarning 
 The user has set changeprime=yes and primestyle=`index', but primeindex still has its default value. This may indicate that the user forgot to set it.
corrective action: No action.
 
primeAtDefaultwarning 
 A new RGS source list is being created, but primeindex still has its default value. This may indicate that the user forgot to set it.
corrective action: No action.
 
primeOutsideFOVwarning 
 The designated prime source is outside the field of view of the RGS camera.
corrective action: No action.
 
tooBigEPICAttrNumwarning 
 Too many (over 99) EPIC source lists are read. As a result the sequence number for it in the header keyword is truncated to 2 digits, which may cause overwriting the pre-existing keywords.
corrective action: The last 2-digit in sequence-ID for EPIC source list is assigned.
 
tooManyEpicBandIdswarning 
 Number of `bandids' specified is more than 9, which will lead to missing information of some band-IDs in the header in the output RGS source list.
corrective action: No action.
 
incompleteLikelyODFwarning 
  The RA and DEC of the proposed position obtained from the ODF are both zero. The ODF is very likely to be incomplete or corrupt (or wrong).
corrective action: Will cause the error unreliableResult at the end.
 
instrumentClashwarning 
 The instrument deduced from the file name does not agree with that deduced from the file header.
corrective action: Header instrument will be used.
 
uncertainInstrumentwarning 
 The instrument has been deduced from the file name.
corrective action: Continues.
 
uncertainExposurewarning 
 No instexpid value was supplied, and there is no EXPIDSTR keyword in the file.
corrective action: Task attempts to deduce exposure number from the file name.
 
badPrimeRatewarning 
 The RATE value of the designated prime source has been found to be less than or equal to zero. Confusion values can therefore not be calculated.
corrective action: Confusion values are set to zero.
 

XMM-Newton SOC -- 2023-04-16