Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/6.5.0/doc/exanalyser.ps.gz
Дата изменения: Tue Aug 16 03:01:04 2005
Дата индексирования: Tue Oct 2 08:33:36 2012
Кодировка:
Поисковые слова: hst

XMM-Newton Science Analysis System Page: 1
exanalyser
August 15, 2005
Abstract
Decide whether an exposure should be analysed in the pipeline
1 Instruments/Modes
Instrument Mode
2 Use
pipeline processing yes
interactive analysis no
3 Description
Within the XMM pipeline it is necessary to make a decision a priori whether a given exposure in an
observation should be passed through the normal \scientic" pipeline.
The task will be called once for each and every exposure in an XMM observation, as the very rst step
in the pipeline analysis. It will provide a simple \go/no go" indication to the pipeline control system
(PCMS) whether the exposure is suitable for passing to the standard pipeline analysis. This decision
is based solely on information readily available from the ODF (via the OAL), for example instrument
mode, lter wheel position (except RGS), exposure duration, etc.
Where exposures are to be ignored by the PCMS, the task will generate an error. This will return a
non-zero exit status to the PCMS, which can then act on this signal and proceed no further with the
analysis of the exposure.
Exposures rejected by exanalyser do not become \invisible", within the pipeline. Data for the unanal-
ysed exposures will be available for use by pipeline tasks should this be required (eg. MOS oset/variance
data exposures). Furthermore output from the summary tasks will still contain information on the un-
analysed exposures.
The current baseline is for exanalyser to reject the following exposures:
xmmsas 20050815 1803-6.5.0

XMM-Newton Science Analysis System Page: 2
EPIC MOS or pn exposures which are not in a supported mode (see list below)
EPIC MOS or pn exposures which are not in a supported lter (see list below)
RGS exposures which are not in a supported mode (see list below)
OM exposures which are not in a supported mode (see list below)
OM exposures which are not in a supported lter (see list below)
Exposures less than 100 seconds in duration
Other, more subtle conditions will doubtless develop as we gain experience with in- ight XMM data.
These extra conditions will be added to exanalyser as they are developed.
In the current version, only the exposure duration condition is implemented, pending an upgrade to the
OAL to read IPPVs. More functionality will be available once the OAL upgrade is available.
EPIC MOS supported modes Prime full window, Prime partial RFS, Prime partial W2,
Prime partial W3, Prime partial W4, Prime partial W5,
Prime partial W6, Fast mode uncompressed
EPIC pn supported modes Prime full window, Prime large window, Prime small window,
Fast mode timing, Fast mode burst
OM supported modes OM science user dened, EPIC M1 image, EPIC M1 image/fast,
EPIC M2 image, EPIC M2 image/fast, EPIC pn image,
EPIC PN image/fast, RGS1 image, RGS1 image/fast,
RGS2 image, RGS2 image/fast, OM image,
OM image/fast
RGS supported modes Spectroscopy baseline, Spectroscopy + Q, HER,
HER with SES, HER with SER, HTR single CCD,
HTR multiple CCD
EPIC supported lters Open, Thin1, Thin2, Medium, Thick
OM supported lters V, Magnier, U, B, White, Visible grism, UVW1, UVM2, UVW2,
UV grism 1, Barred-U
4 Parameters
This section documents the parameters recognized by this task (if any).
Parameter Mand Type Default Constraints
instrument yes string One of EMOS1,
EMOS2, EPN, RGS1,
RGS2, OM
Instrument name
exposureid yes integer > 1
Exposure identier within an observation
xmmsas 20050815 1803-6.5.0

XMM-Newton Science Analysis System Page: 3
5 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.
noExposure (error)
Exposure with specied ID cannot be found
badFilter (error)
Exposure should not be analysed (unknown or disallowed lter)
badMode (error)
Exposure should not be analysed (contains data from unknown or disallowed modes)
badDuration (error)
Exposure should not be analysed (exposure duration below threshold)
6 Input Files
1. ODF summary le (via OAL)
7 Output Files
None.
8 Algorithm
subroutine exanalyser
Check instrument/exposure ID match up
Read instrument mode (via OAL)
Read filter (via OAL)
Read exposure duration (via OAL)
Check exposure duration
Check instrument mode
Check instrument filter
end subroutine exanalyser
xmmsas 20050815 1803-6.5.0

XMM-Newton Science Analysis System Page: 4
9 Comments
The task as described relies on the OAL being able to return the instrument mode (as
distinct from the data mode) for an exposure. If the OAL cannot be used as the source of
this information, the task will have to read the IPPVs from the summary le directly.
10 Future developments
References
xmmsas 20050815 1803-6.5.0