Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/7.1.0/doc/echeckregion.ps.gz Дата изменения: Mon Jul 9 10:17:52 2007 Дата индексирования: Tue Oct 2 11:31:13 2012 Кодировка: Поисковые слова: п п п п п п п п п п п п п п п п п п п п п п п п п п

XMM-Newton Science Analysis System Page: 1
echeckregion
July 9, 2007
Abstract
A task to check whether a region falls within the exposed part of an EPIC camera.
1 Instruments/Modes
Instrument Mode
EPIC IMAGING, TIMING
2 Use
pipeline processing yes
interactive analysis yes
3 Description
echeckregion calculates whether the centre of an input region falls on an exposed part of an EPIC CCD.
If the area falls on a chip, but outside the telescope eld-of-view or outside the observing window, for
small and large-window observations, the output status is set false. Otherwise status is set true.
4 Example
To nd whether a circular extraction region falls within the observing window:
echeckregion srcexp='(X,Y) in circle(40847,28797,560)'
table=EPN ImagingEvts.ds
5 Parameters
This section documents the parameters recognized by this task (if any).
Parameter Mand Type Default Constraints
xmmsas 20070708 1801-7.1.0

XMM-Newton Science Analysis System Page: 2
srcexp yes string
Spatial Expression for checking
table yes table
specier
event list table speci-
er
A table specier which must point to an event list table in a data set. It must be in either of the forms
setname or setname:tableid where setname must be the name of an existing data set and tableid the
name of a table in the specied data set. If the rst form, setname, is used, the event data are sought in
the rst block of the named data set.
status no boolean
Output parameter. This is set to false if the centre of the input region does not fall on an exposed part
of a CCD. Otherwise it is set true.
6 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 docu-
mented here. Refer to the index of all errors and warnings available in the HTML version of the SAS
documentation.
InvalidExpression (error)
The input expression for this spatial region was not valid.
RegionInvalid (error)
The input region either doesn't contain region information or it is unbounded in detector
coordinates.
7 Input Files
 an EPIC calibrated events list from the pipeline, the e*proc or e*chain tasks.
8 Output Files
9 Algorithm
status=true
calculate region_centre in detector coords
find CCD number for this detector position
xmmsas\_20070708\_1801-7.1.0

XMM-Newton Science Analysis System Page: 3
if (region_centre outside observing window for this CCD)
{
status = false
}
if (region_centre outside field-of-view)
{
status = false
}
return status
10 Comments
References
xmmsas 20070708 1801-7.1.0