Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/6.1.0/doc/emproc.ps.gz Дата изменения: Tue Nov 23 00:57:44 2004 Дата индексирования: Tue Oct 2 02:29:29 2012 Кодировка: Поисковые слова: http astrokuban.info astrokuban

XMM-Newton Science Analysis System Page: 1
emproc
November 22, 2004
Abstract
Process the epic mos part of an Observation Data File.
1 Instruments/Modes
Instrument Mode
EPIC MOS IMAGING, TIMING, COM-
PRESSED IMAGING, COM-
PRESSED TIMING
2 Use
pipeline processing no
interactive analysis yes
3 Description
emproc is one of the two tasks in the SAS package epicproc. Please refer to the documentation in
epicproc for information on most of the functionality available in emproc.
In the following we describe some of the MOS-specic task parameters. These can be found in the
parameter dialog box labeled Details, but there are a few exceptions to this rule as noted below. The
following subsections are titled as the panes in the parameter dialog.
The parameter dialog box is automatically displayed if the task is run from the SAS graphical user
interface sas. On the command line one can achieve the same eect by typing emproc -d. (See also the
documentation of package taskmain.)
3.1 Bad Pixels
Parts of the observation can be excluded from the search for bad pixels by giving emproc an additional
GTI le via the parameters withbadpixgti and badpixgti.
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 2
For instance:
emproc --withbadpixgti=yes --badpixgti=mygti.ds
3.2 Details
In general there is no need to modify any of the parameters described in this section.
3.2.1 emframes
3.2.2 emevents
The following emevents parameters can be altered: keepsifluor, randomizeposition, rejectrows,
maxeventsperrow, and randomizetime.
3.2.3 emenergy
The following emenergy parameters can be altered: useccfdarkframe, and randomizeenergy.
3.3 Examples
 emproc --selectinstruments=yes --emos1=yes
Process only the imaging exposures for EMOS1.
 emproc --timing=yes --withsrccoords=yes --srcra=xxx --srcdec=xxx
Process also the timing exposures. The source coordinates should be given. (See also the
task emframes.)
4 Parameters
This section documents the parameters recognized by this task (if any).
Parameter Mand Type Default Constraints
selectinstruments no b false yes j no
Select one of the cameras?
emos1 no b false yes j no
Process EMOS1 data
emos2 no b false yes j no
Process EMOS2 data
removetemporaries no b true yes j no
Remove temporary data sets?
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 3
removeintermediategtis no b true yes j no
Remove intermediate GTI data sets?
removeintermediateeventlistsno b true yes j no
Remove the intermediate CCD/node-based event lists?
withinstexpids no b false yes j no
Select exposures to process?
instexpids no S 'M1S001 M2S001'
List of exposures to process.
selectccds no b false yes j no
Select the CCDs to process? false = process all CCDs.
ccd1 no b false yes j no
Process data for CCD 1?
ccd2 no b false yes j no
Process data for CCD 2?
ccd3 no b false yes j no
Process data for CCD 3?
ccd4 no b false yes j no
Process data for CCD 4?
ccd5 no b false yes j no
Process data for CCD 5?
ccd6 no b false yes j no
Process data for CCD 6?
ccd7 no b false yes j no
Process data for CCD 7?
selectmodes no b true yes j no
Select the modes to process? false = process all modes.
imaging no b true yes j no
Process imaging mode exposure?
rimaging no b true yes j no
Process reduced imaging mode exposure?
timing no b true yes j no
Process timing mode exposures?
ctiming no b false yes j no
Process compressed timing mode exposures?
withgtiset no b false yes j no
Use an external GTI dataset to be used when ltering the data?
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 4
gtiset no e gti.ds
Name of the external GTI dataset to be used when ltering the data.
runhkgtigen no b false yes j no
Generate a GTI dataset based on housekeeping?
runatthkgen no b true yes j no
Pre-process attitude data through atthkgen?
referencepointing no s object nominal|object|mean|median|user
Coordinates of the reference poiting used for the calculation of the sky coordinates
ra no u 0.0  0.0 {  360.0
User-specied right ascension of s/c attitude (deg)
dec no u 0.0  -90.0 {  90.0
User-specied declination of s/c attitude (deg)
posangle no u 0.0  -180.0 {  180.0
User-specied astronomical position angle of s/c attitude (deg)
lterevents no b true yes j no
Filter the event lists?
aglteredevents no b false yes j no
Flag the events that match the lter expression instead of removing them?
applygti no b true yes j no
Apply GTI lter to the event lists?
runevlistcomb no b true yes j no
Merge CCD-level event lists into exposure-level event lists (by mode)?
searchforbadpixels no b yes yes j no
Search for bad pixels?
searchforbadcolumns no b true yes j no
Look for bad columns?
withbadpixgti no b false yes j no
Search for bad pixels only in the given good time intervals?
badpixgti no e bapixgti.ds
Good time intervals to use while searching for bad pixels.
thresholdlabel no s rate peak|rate|counts
Thresholds choice - as percentage of PEAK, as count RATE or pure COUNTS [!badpixnd]
lothresh no r 0.0  0.0
Low threshold to search for dead pixels [badpixnd]
hithresh no r 0.005  0.0
High threshold to search for hot pixels [!badpixnd]
columnsearchlabel no s median median|total
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 5
Columnsearch thresholds choice - refer to TOTAL column value or MEDIAN column value [badpixnd]
locolthresh no r 0.0  0.0
Low threshold to search for dead columns [badpixnd]
hicolthresh no r 0.002  0.0
High threshold to search for hot columns [badpixnd]
ickertimesteps no i 1  1
Number of timesteps to search for ickering pixels [badpixnd]
ickerksthresh no r 0.55  0 {  1
K-S threshold for low count ickering pixels [badpixnd]
ickerchisqthresh no r 15.0  0
Reduced Chi-sq threshold for high count ickering pixels [badpixnd]
backgroundrate no r -1 none
Background rate (ct/s/pix) - if negative, mean over entire eld assumed [!badpixnd]
narrowerthanpsf no r 3  0.0
PSF-pixel(s) comparison - 1:equal to PSF, >1:more compact [!badpixnd]
threshabovebackground no b no yes j no
High thresholds as values above background [badpixnd]
loenergythresh no r 0  0 {  30.0
Low energy threshold for searching (keV) [badpixnd]
hienergythresh no r 30.0  0 {  30.0
Hi energy threshold for searching (keV) [badpixnd]
useccfdarkframe no b no yes j no
Use dark frame in CCF [emenergy]
randomizeenergy no b yes yes j no
Randomize PHA within one ADU bin [emenergy]
keepsi uor no b no yes j no
Keep as one event diagonals with Si uorescence [emevents]
randomizeposition no b yes yes j no
Randomize DETX/DETY within one pixel [emevents]
rejectrows no b yes yes j no
Throw away rows/frames with too many events [emevents]
maxeventsperrow no i 4  1
Maximum number of events per row/frame [emevents]
randomizetime no b true yes j no
Randomize TIME within one frame [!emevents]
withsrccoords no b no yes j no
Provide source coordinates (Timing only) [emframes]
xmmsas 20041122 1834-6.1.0

XMM-Newton Science Analysis System Page: 6
srcra no u 0. none
Source right ascension (J2000) [emframes]
srcdec no u 0. none
Source declination (J2000) [emframes]
withparameters no b false yes j no
Specify explicit list of HK parameters? [hkgtigen]
parameters no S
List of HK parameters to consider [hkgtigen]
except no b false yes j no
Consider all parameters except those specied [hkgtigen]
withoverrideparameters no b false yes j no
Specify list of additional parameters? [hkgtigen]
overrideparameters no S
List of override/additional parameters [hkgtigen]
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.
SubTaskError (warning)
emproc has detected an error from one of the sub-tasks.
corrective action: The processing of the current data set is abandoned.
NoEventListsToMerge (warning)
There are no event lists to merge into an exposure-level data set. This can be caused by errors
in some of the tasks. Examine the output of emproc. See also the warning SubTaskError.
corrective action: none
IntermediateEventListsNotRemoved (warning)
The user set runevlistcomb and removeintermediateeventlists to true, and the event
list combination stage failed. As a consequence emproc does not remove the intermediate
event lists.
corrective action: The intermediate event lists are not removed.
References
xmmsas 20041122 1834-6.1.0