CHAV updated for CIAO 4.3

[Alexey Vikhlinin]

New CHAV (v.2011.01.25) is the most significant update in years.

1. Support for new options in acis_process_events is included in the
"window".

The most significant new option in a_p_e is the temperature-dependent
CTI correction. This, e.g., fixes a "soft component" in the Coma
spectrum from the latest ACIS-I calibration observation. Apply this
for all new data.

Another new option is the application of a subpixel algorithm to
compute the photon positions. I have no comments on this one

2. Support for correct ACIS contamination files: since the right
contamination model is now official for all CCDs, I can distribute
calcarf / chipmap2 which support it. Check out best

3. I am migrating from Linux to Mac. The latest release includes a
binary distribution for the latest OS X (Snow Leopard 10.6.6) which
you should be able to unpack and run out of the box.

*********************** Installation
************************************************

1. Get and install ciao-4.3. Binary is OK but make sure you install a
32-bit version. Their default scripts installs a 64-bit one if you're
running a 64-bit OS.

2. Get chav:

mac osx binaries: http://hea-www.harvard.edu/~alexey/CHAV/chav-macox.zip
source code: http://hea-www.harvard.edu/~alexey/CHAV/chav-src.tar.gz

If you install mac binaries, simply unpack them somewhere (e.g. into /
soft )

If you install from source, go to chav-src/chav, edit and run
configure with suitable options (see the entry alexey-ciao43-32 as an
example)
make; make install
do the same in chav-src/acisbg (the code developed by Maxim
Markevitch)

3. Get the calibration dataset:
http://hea-www.harvard.edu/~alexey/CHAV/CAL.tar.gz
unpack it into the directory where you installed CHAV (e.g., /soft/
chav in the case of the mac binaries)

4. Get parameter files:
http://hea-www.harvard.edu/~alexey/CHAV/Par.tar.gz
and also unpack it into the CHAV install dir.

5. Separately, get Maxim's background datasets. At my place, I also
make a directory /soft/chav/BG with convenient links to the background
files:

lrwxr-xr-x 1 alexey staff 42 Nov 1 17:23
acisi_E_01236_bg_evt.fits -> ../bgdata/
acisi_E_01236_bg_evt_201209.fits
lrwxr-xr-x 1 alexey staff 28 Oct 18 18:49 badpix_E -> ../bgdata/
badpix_E_110210y10

6. After you initialize the package as described below, you should be
able to run everything. In the process_acis_data window, you'll notice
two new flags:
T-dependent CTI (you'll need to download and set the mlt1 file for
your observation to use this option)
and subpix positions

If you'd like to process old datasets exactly as before, unset thes
options.

***** CHAV + FTOOLS + CIAO initialization file:
************************************************

# LOAD ftools:
source ~/.ftools12

# LOAD chav
setenv CH /soft/chav
set path = ( $path $CH/bin )

# if sm is something else then the plain supermongo binary,
setenv SUPERMONGOBINARY /usr/local/bin/sm

# LOAD ciao
source /soft/ciao/bin/ciao.csh

# use fitsfilter if your machine has little RAM
setenv FITSFILTER $CH/bin/fitscopy

# move FTOOLS and CIAO at the end of path
set path = `echo $path | perl -ne '{ chomp; @dirs = split; @cdirs =
(); foreach $dir (@dirs) { if ($dir =~ /ciao/) { push @cdirs,
$dir; $dir=""; } } print join (" ",@dirs,@cdirs,"\n");}'`
set path = `echo $path | perl -ne '{ chomp; @dirs = split; @cdirs =
(); foreach $dir (@dirs) { if ($dir =~ /heasoft/) { push @cdirs,
$dir; $dir=""; } } print join (" ",@dirs,@cdirs,"\n");}'`

# reset PFILES
setenv PFILES `printenv PFILES | perl -pe '{s/cxcds_param4/SYS
\/.cxcpfiles4/; s/alexey\/pfiles/alexey\/SYS\/.pfiles/}'`
rmdir ~/pfiles ~/cxcds_param4

# personal settings:
setenv P_A_D_GAINFILE `getpar matching_gainfile @$CH/Par/best_cal.par
rp_expand_vars=no`

# # To get the latest CALDB gain file, use
# set govdate = `date +%Y-%m-%d`
# setenv P_A_D_GAINFILE `quizcaldb infile=none mission=chandra
instrument=ACIS detector=- date=$govdate time=00:00:00 filter=-
codename=DET_GAIN expr=cti_corr.eq.yes | perl -pe '{s/\[.*//;
s(^'$CALDB')(\$CALDB)}'`

[Alexey Vikhlinin]

(When you copy the initialization file example above, make sure that
the stuff between ` and ` ends up on one line in your file`