| badOutUnit | error | |
| The value of outunit was not recognized. | ||
| badInstrum | error | |
| The value of the INSTRUME keyword of the event list was not one of the XMM EPIC instruments. | ||
| noSourcesSelected | error | |
| None of the sources in the input event list passed the filter specified by expression. | ||
| tooFewRows | error | |
| When operationstyle=`single' a single source is specified via the usersrcid parameter. This refers to the row number of the filtered source list (note the first row is assumed to be numbered 1 not 0). The present error occurs if the number of rows is less than usersrcid. | ||
| nonUniqueSrcId | error | |
| When operationstyle=`batch', it is necessary to assign a unique identification integer to each source, because the extension names in which the regions are stored contain this integer. The integer is taken from a column specified via the srcidcol parameter. The present error occurs if any value of the integer specified in this column occurs more than once (in the filtered source list). | ||
| badIdBand | error | |
| At present it is necessary that the source list must contain an ID_BAND column. This is to allow the energy limits of the source detection band to be determined. ID_BAND numbers must be between 0 and 9 inclusive, otherwise the task does not know how to decode them. | ||
| badEnergyBandEdges | error | |
| The 'lower' energy was found to be higher than the 'higher' energy for this band! This is probably a bug. | ||
| notSupported | error | |
| Flags a mode which is not yet supported. | ||
| badBkgFluxStyle | error | |
| The value of bkgratestyle was not recognized. | ||
| badRadiusStyle | error | |
| The value of radiusstyle was not recognized. | ||
| badOperationsStyle | error | |
| The value of operationstyle was not recognized. | ||
| energyThetaOrPhiOutOfRange | error | |
| This occurs as the task attempts to access the PSF stored in the XMM calibration files via a cal
library call. This call returns the PSF only for a limited range of source energy and position. The position is specified in the polar coordinates (theta,phi) of the TELCOORD system (see the cal
documentation for details). Actually only one out-of-range condition is accepted: if theta (the off-axis angle) exceeds its cal
limit, a warning rather than an error is generated and the limiting value is substituted. This difference is because the theta range does not quite cover the actual instrument extent, thus the theta-over-range condition occurs rather often in practice; whereas the other out-of-range conditions should not occur at all. | ||
| nonRealSrcRadii | error | |
| Indicates a bug in the confused-source-radius shrinking routine. Report this to the code developer. | ||
| doubledSource | error | |
| This occurs when the task is attempting to eliminate overlap between source-regions of confused sources. However, many source lists contain more than one entry for the same position (say, to record the source flux at different energies). This is clearly not the same thing as a confused source and it is not desirable that the regions for all such duplicated source positions be shrunk to zero in an attempt to remove such spurious `confusion overlap'. The task attempts to detect such duplicated source positions and fails with the present error if it finds any. the solution is to filter these duplicated sources from the list and then resubmit the list to region. | ||
| tooManyRows | warning | |
| When operationstyle=`batch', regions are stored in FITS binary table extensions which have names containing an identifying integer. The maximum value of this (from length considerations of the extension name string) is presently 9999. If there are more than 9999 source in the (filtered) input list, the present warning will be generated.
corrective action: The task only stores regions for the first 9999 sources. | ||
| nonUniqueIdBand | warning | |
| More than one value of ID_BAND was detected in the source list. This implies that the list contains more than one row for one or more of the source positions. In this case several concentric regions will be produced for these sources. If you don't want this to happen you should filter the source list (the task can do this for you via its expression parameter) so that only one value of ID_BAND remains.
corrective action: The task takes no corrective action. | ||
| noBandEnergy | warning | |
| The task couldn't work out the source energy. This may be a bug and should be reported to the code developer.
corrective action: The task uses a default energy value. | ||
| srcThetaTooLarge | warning | |
| This occurs as the task attempts to access the PSF stored in the XMM calibration files via a cal
library call. This call returns the PSF only for a limited range of source energy and position. The position is specified in the polar coordinates (theta,phi) of the TELCOORD system (see the cal
documentation for details). However, the theta range does not quite cover the actual instrument extent, thus the theta-over-range condition is probably going to happen sooner or later. There's no cause for alarm.
corrective action: The task uses the maximum value of theta instead. | ||
