Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/6.1.0/doc/emeventsproj.ps.gz Дата изменения: Mon Nov 22 23:36:28 2004 Дата индексирования: Tue Oct 2 11:20:07 2012 Кодировка:

XMM-Newton Science Analysis System Page: 1
emeventsproj
November 22, 2004
Abstract
Project EPIC-MOS events le (one node of one CCD) onto map.
1 Instruments/Modes
Instrument Mode
EPIC MOS IMAGING
2 Use
pipeline processing yes
interactive analysis yes
3 Description
emeventsproj projects a list of events onto an image, projecting multiple events onto several pixels
(using the geometry contained in PATTERN). The output image is always 600x600 (even in Window mode)
and covers the CCD only (not the under and overscans). The main use of emeventsproj is to prepare
an image for embadpixnd.
emeventsproj works both on raw events les straight from the ODF, on merged PPS event lists, and
on single CCD events le processed by emevents. The latter solution is the only one allowing full
functionality. If the input le is a merged PPS event list, the mergedeventlist and ccdnr parameters
must be set.
When rejectbadevents=Y, events agged for rejection are not included in the projection. The ags
OUT OF FOV and REJECTED BY GATTI are ignored, because it is useful to nd bad pixels outside the eld
of view, and masking the truncated events would prevent from detecting single bright pixels with charge
larger than the upper threshold. The rejectbadevents option is not supported if the input events le
is straight from the ODF, because there is no FLAG there. If another selection on events is required, then
it should be done via evselect prior to calling emeventsproj.
When projectenergy=Y, energy is projected instead of counts. For each event, ENERGYE1 is added to
the map at the events position (instead of 1), and ENERGYE2 is shared among all secondary pixels of the
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 2
events (exact reconstruction of the original charge pattern is impossible for events larger than 2 pixels).
ENERGYE3 and ENERGYE4 are not projected.
If a single frame were selected in the events le, the output image would look like the original CCD map
read-out on-board after thresholding, minus all charge patterns which did not pass the EDU (and agged
events if rejectbadevents=Y). The same algorithm is used in emevents when analysepatterns=Y.
The projectenergy option is not supported if the input events le is a merged PPS event list, because
there is no ENERGYE1 and ENERGYE2 there.
4 Parameters
This section documents the parameters recognized by this task (if any).
Parameter Mand Type Default Constraints
eventset yes dataset ' ' none
Input events le from ODF or previous emevents run
evimageset no dataset events.map none
Output image le
rejectbadevents no boolean no yes/no
Reject events agged as bad when constructing image
projectenergy no boolean no yes/no
Project energy rather than counts (not useful for embadpixnd)
mergedeventlist no boolean no yes/no
Is the input le a merged PPS event list
ccdnr no integer 1 1-17
CCD number (CCDNR value). If this parameter is set, then mergedeventlist=Y is automatic
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.
getparamvalues03 (error)
projectenergy=Y and merged PPS events le
getparamvalues10 (warning)
rejectbadevents=Y and events le from ODF. Ignore option
corrective action: run emevents and emenergy if you wish to reject bad events
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 3
6 Input Files
1. event le (from ODF or emevents).
7 Output Files
1. Projected image le (for embadpixnd) as Integer*4 array in PRIMARY.
8 Algorithm
Read the parameters
Read events list
if rejectbadevents then
Select events not flagged for rejection
(but keep OUT_OF_FOV and REJECTED_BY_GATTI)
endif
if mergedeventlist Select CCDNR == ccdnr
Read event patterns
Loop over events
if projectenergy then
Add ENERGYE1 to central pixel
Share ENERGYE2 among other pixels of current event
else
Add 1 to all image pixels sharing into current event
endif
endloop
Write projected map
9 Comments
None.
References
xmmsas 20041122 1834-6.1.0