Oberon Version

Ian M George: Ciao, FTOOLS & General Set-up

These pages are unofficial in all respects. They are primarily simply notes to myself. The information is not guaranteed to be correct or up-to-date. 

Last Updated: 2004 Jun 20

Making the Software packages available

[If you have not already done so in the working window/shell] make sure you have all the software packages available by: 
source /data/oberon6/george/software/ciao/ciao3.0.1/bin/ciao.csh
source /software/lheasoft/release/lhea.csh

Keep Good Notes!

It is essential you keep good notes. I suggest you do this by writing into an appropriately named file in to work directory of each dataset.

SO 

cd {targetdir}/work_ciao3.0.1
emacs analysis_notes.txt &
(which will result in an emacs window opening)

The first set of things to note are:

  • date
  • which version of CIAO you are using
    (which have been displayed when you issued the command above)
  • which version of the CXO calibration files you are using. This can be obtained by pasting the result of the following command into your notes:
    ls -ltr $CALDB
From now on, I'd like you to record all the commands you issue in the analysis_notes.txt file. You do not have to record all the screen output - unless of course there are error messages etc. (but if in doubt - record it...)

Find (& Record) some Important Files

Find the most important files downloaded in the tt file by running the following: 
/data/oberon5/george/data/axaf/scripts/hetgs_list.csh
which should give output which looks something like this: 
   Event files......................
   ../primary/acisf02090N003_evt2.fits.gz
   ../secondary/acisf02090_001N003_evt1.fits.gz
   Bpix files... ...................
   ../primary/acisf02090_001N003_bpix1.fits.gz
   ls: ../secondary/*bpix*: No such file or directory
   Asols files......................
   ../primary/pcadf099428181N003_asol1.fits.gz
   Flt files.....  .................
   ../secondary/acisf02090_001N003_flt1.fits.gz
   .................................
You'll have to substitute some of these names into the following (& some later) stage of the recipe... Basically we now know the name of
  • the basic starting dataset of our analysis - the 1st event (evt1) file (denoted {evt1} below)
  • the "bad pixel" (bpix1) file ({bpix1} below)
  • the "aspect solution" (asol1) file (there could be more than one of these - see below)
  • the "filter" (flt1) file ({flt1} below)
These files are actually all compressed, the following script will uncompress them, and a dump some useful information from the evt1 file concerning the instrumental set-up: 
/data/oberon5/george/data/axaf/scripts/hetgs_prep.csh {evt1} {bpix1} {flt1}
Note this script takes the filenames (actually without the gz extension) as input. So, in the above extension, the actual command would be... 
/data/oberon5/george/data/axaf/scripts/hetgs_prep.csh ../secondary/acisf02090_001N003_evt1.fits ../primary/acisf02090_001N003_bpix1.fits ../secondary/acisf02090_001N003_flt1.fits
The output should look something like: 
   # FILE: ../secondary/acisf02090_001N003_evt1.fits+
   # KEYNAME: DETNAM
   # EXTENSION:    1
   DETNAM  = 'ACIS-456789'        / Detector
   # FILE: ../secondary/acisf02090_001N003_evt1.fits+
   # KEYNAME: READMODE
   # EXTENSION:    1
   READMODE= 'TIMED   '           / Read mode
   # FILE: ../secondary/acisf02090_001N003_evt1.fits+
   # KEYNAME: DATAMODE
   # EXTENSION:    1
   DATAMODE= 'FAINT   '           / Data mode

Write a Text File for the Aspect Files

For simplicity (in case there is more than one asol1 file) do the following: 
gunzip ../primary/*_asol1.fits.gz
ls ../primary/*_asol1.fits* > ../primary/pcad_asol1.lis
This pcad_asol1.lis wil be used later.

Onto the Next Step

Other AXAF-related CribSheets
Other CribSheets
Ian M George Home Page