NAME

ctifunc -identify events, merge events from different obsid, extract spectra from events, then fit models to the spectra.

SYNOPSIS

  ctifunc  -e @aciseventsparfilename -f @aciscalsrcfitparfilename -i inputrdbfilename
  [ -c chunks ] [ -D listofworkstations ] [ -h ] [ -I iterationnumber ]
  [ -m parname=parval ] [ -O ouputFname ] [ -r ] [ -u ] [ -v ] [ -T ]

OPTIONS

The options are :

-c integer
The number of chunks, the number must divide integrally into 1024. The default value is 32. 
 ctifunc -c 2 -i inputrdbfilename -e @aciseventspar -f @aciscalsrcfitpar

-D list
A comman seperated list of workstations to distribute the workload of the script.

-e string
The file containing the options for acisevents which do not change. The user must preceede the filename with an ampersand character (@), the ampersand is not part of the filename but is present to indicate that the file contains multiple lines/options. 
 ctifunc -e @aciseventspar -f @aciscalsrcfitpar -i ctifuncinput.rdb

A sample of the file containing the options which are passed to acisevents is given below:

dumbo-148: cat aciseventspar

 --Stats median
 --algorithmbias quadrant
 --ethreshold 38
 --sthreshold 13

-f string
The file containing the options for aciscalsrc-fit which do not change. The user must preceede the filename with an ampersand character (@), the ampersand is not part of the filename but is present to indicate that the file contains multiple lines/options. 
 ctifunc -e @aciseventspar -f @aciscalsrcfitpar -i ctifuncinput.rdb

dumbo-149: cat aciscalsrcfit

 -i 3
 -t test
 -c 32
 -n 3
 -N Al,Ti,Mn

-h
To see a brief instructions on how to use this program. For example: 
 ctifunc -h

-i string
The input rdb file containing the following columns: obsid, biasfilename, coloffset, imagedir, framenum. A sample input file: 
 dumbo-908: tbl2lst < ctifuncinput.rdb
 #
 # The rdb file must contain the following columns:
 # obsid, biasfilename, coloffset, imagedir, framenum.
 #
 # obsid, the observation id to be processed.
 # biasfilename, bias frame created using fitsstats.
 # coloffset, the column offset.
 # imagedir, the directory where the image files reside.
 # framenum, the range option for the acisevents program.
 #
        obsid | N
 biasfilename | S
    coloffset | N
     imagedir | S
     framenum | S
        obsid | 61705
 biasfilename | /data/dumbo0/dtn/data/61705/obs61705_bias.fits
    coloffset | 953
     imagedir | /data/dumbo0/dtn/data/61705
     framenum | 1104:1107,1115:1119
        obsid | 61678
 biasfilename | /data/dumbo0/dtn/data/61678/bias61768.fits
    coloffset | 953
     imagedir | /data/dumbo0/dtn/data/61678
     framenum | 1100/25

-I string
The iteration number. 
 ctifunc -e @aciseventspar -f @aciscalsrcfitpar -i ctifuncinput.rdb -I 3

-m string
The model parameter to be passed to the script acisevents. 
 ctifunc -e @aciseventspar -f @aciscalsrcfitpar -i ctifuncinput.rdb -m cti=1.4e-4

-O string
The output filename.

-r
 ctifunc -e @aciseventspar -f @aciscalsrcfitpar -i ctifuncinput.rdb -m -r

If present then the Fits file in the iter00x subdirectory shall be removed.

-u
To see a detailed instructions on how to use this program. For example: 
 ctifunc -u

-v
Print debug statements as the script executes. 
 ctifunc -v