Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/5.4.1/doc/dpsssrc.ps.gz Дата изменения: Fri Jan 10 22:23:27 2003 Дата индексирования: Tue Oct 2 03:12:05 2012 Кодировка: Поисковые слова: antarctica

XMM-Newton Science Analysis System Page: 1
dpsssrc
January 10, 2003
Abstract
The task dpsssrc is part of the automatic validation process of the Data Product
Screening System (DPSS). The task creates a copy (with the prex ag ) of a EPIC
Maximum-Likelihood detection list. The task is designed to speed up the work of
the subsequent visual verication step based on the DPSS GUI. Three columns are
created by the task: (i) IND SOL, (ii) VER FLAG and (iii) VER COMM. These three columns
are necessary for the work with the DPSS GUI. The column IND SOL is lled with
a running number, starting from 1 to the number of rows in the source table. The
column VER FLAG contains the source ag setting. The column VER COMM is expected
to contain source comments, which will be applied during the visual verication step.
The source ag source likelihood below a certain threshold (position 2 of the
column VER FLAG) is set to T, when the source likelihood listed in the column DET ML of
the EPIC Maximum-Likelihood detection list is below a certain threshold. In addition
the columns A, E, N, P, G, X are created, containing individual source ags.
1 Instruments/Modes
Instrument Mode
EPIC IMAGING, TIMING, BURST
2 Use
pipeline processing yes
interactive analysis no
3 Description
The SAS task dpsssrc is part of the Data Product Screening System (DPSS), which is divided into
an automatic step (described here) and a subsequent visual verication step based on Graphical User
Interfaces. The separation into an automatic validation and a visual verication process has been proven
as an eective and powerful method to secure a high quality of data products produced by a standard
analysis software. The SAS task dpsssrc is designed to speed up the work of the visual verication step by
creating a copy of the EPIC Maximum-Likelihood source list containing three new column necessary for
the work with the DPSS GUI. The columns created by the task are named as: (i) IND SOL, (ii) VER FLAG
and (iii) VER COMM. The column IND SOL (data format: 4-byte INTEGER) is lled with a running number,
xmmsas 20030110 1802-5.4.1

XMM-Newton Science Analysis System Page: 2
starting from 1 to the number of rows in the source table. The column VER FLAG (data format: A10)
contains the source ag setting (the pre ag setting is: FFFFFFFFFF, i.e. none of the source ags is given to
a source). In addition the columns A, E, N, P, G and X are created containing the ag setting of individual
source ags. The column VER COMM (data format: A20) is created to be lled with source comments
during the visual verication step. The source ag source likelihood below a certain threshold
(position 2 of the column VER FLAG) is set to T, when the source likelihood listed in the column DET ML
is below a certain threshold.
4 Parameters
This section documents the parameters recognized by this task (if any).
Parameter Mand Type Default Constraints
set yes string P0123700101PNS003EMSRLI0000.FITapplies only for EPIC
Maximum-Likelihood
detection lists
EPIC Maximum-Likelihood source list, identier TTTTTT = EMSRLI
maxlikthresh no real
value
50. must be greater than
0.
threshold to set the source ag `source likelihood below a certain threshold' to T
prex no string ag applies only for EPIC
Maximum-Likelihood
detection lists
prex for output name (prefix set)
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.
error (FITSIO), FITS error 104: could not open the named le (error)
The ts le does not exist or does not have read permission
error (badInput), input PPS le is not the EPIC M-L detect list (error)
The input le is not a EPIC M-L detection list. The identier TTTTTT of the input PPS le
(naming convention is given in [1] and SSC-LUX-TN-0038) is not equal to EMSRLI.
xmmsas 20030110 1802-5.4.1

XMM-Newton Science Analysis System Page: 3
6 Input Files
1. POOOOOOOOOODDSEEEEMSRLISXXX.FITEPIC Maximum-Likelihood detection source
List. The identier for TTTTTT must be equal to EMSRLI. The naming convention given above
is according to [1] and SSC-LUX-TN-0038.
7 Output Files
1. ag POOOOOOOOOODDSEEEEMSRLISXXX.FIT
Copy of a EPIC Maximum-Likelihood detection list. Three new column are created and the
source ag setting for sources below a certain detection threshold is performed.
8 Algorithm
*** test, if M-L detect list is called TTTTTT = EMSRLI
xxx = stringParameter("set")
tttttt = xxx(17:22)
if (tttttt .eq. "EMSRLI") then
else
call error("badInput", "input PPS file is not the EPIC M-L detect list")
return
endif
*** make a copy of the input file with prefix flag
write (outname,'(a,a)') "flag_",trim(stringParameter("set"))
call copyDataset(stringParameter("set"),outname)
*** pointer to file and table
outfile = dataSet(outname,MODIFY)
outtab = table(outfile,"SRCLIST")
*** create new columns
ind_sol = addColumn(outtab,"IND_SOL",INTEGER32,units="I",comment="running number")
ver_flag = addColumn(outtab,"VER_FLAG",String," ",(/10/))
ver_comm = addColumn(outtab,"VER_COMM",String," ",(/20/))
*** pointer to column ind_sol and to entries in column
indsol => int32Data(ind_sol)
*** pointer to column ind_sol and to entries in column
det_ml = column(outtab,"DET_ML",READ)
p_detml => real32Data(det_ml)
*** write column ind_sol
do i = 0, numberOfRows(outtab) - 1
indsol(i) = i + 1
enddo
xmmsas\_20030110\_1802-5.4.1

XMM-Newton Science Analysis System Page: 4
*** write column ver_flag
pnflag1 = "FFFFFFFFFF"
do i = 0, numberOfRows(outtab) - 1
call setStringCell(ver_flag, i, pnflag1);
enddo
*** write column ver_comm
comment = ". "
do i = 0, numberOfRows(outtab) - 1
call setStringCell(ver_comm, i, comment);
enddo
*** make flag setting for not_checked sources
thresh = realParameter("maxlikthresh")
pnflag3 = "FTFFFFFFFF"
do i = 0, numberOfRows(outtab) - 1
if (p_detml(i) < thresh) then
call setStringCell(ver_flag, i, pnflag3);
endif
enddo
9 Comments
 This task only applies for EPIC Maximum-Likelihood detection lists.
10 Future developments
The command line parameter 2 (maxlikthresh) used for the ag setting of sources below a certain
detection threshold has to be dened on basis of in- ight data.
References
[1] SSC. XMM Survey Science Centre to Science Operations ICD for SSC Products. Technical Report
XMM-SOC-ICD-0006-SSC Issue 2.1, SSC, Mar 2000.
xmmsas 20030110 1802-5.4.1