****************************  README *************************

AGILE SW Package:  AGILE_SW_4.0_SourceCode
(Agile Data Center, 06-10-2009)

The package AGILE_SW_4.0_SourceCode contains 3 files:
two .tgz files and this readme file:

- BUILD_GRID_4.0.tgz ( ~ 260 M)    
- test_dataset_4.0.tgz ( ~ 240 M ) 
- readme_4.0.txt ( ~ 4 K)

External software requirements:
- heasoft/headas v. 6.1.2 or later
  available from http://heasarc.gsfc.nasa.gov/docs/software/lheasoft/download.html
- root v. from 5.14 to 5.20 
  available from http://root.cern.ch/root

Users have to install the required external software on their computer.
The AGILE data analysis software was built with versions:
 heasoft v. 6.1.2
 root v. 5.14

- Once untarred, the directory BUILD_GRID_4.0 contains source codes, libraries
  and calibration files for AGILE data analysis.
  The tar file also includes the file SoftwareReleaseNote.txt  and the 
  User Manual (AGILE-IFC-OP-009_Build-19.pdf).
  The current version of the public software delivered with this Release 4.0
  reflects the current best understanding and testing of calibrations, 
  background rejection, and processing results.
  The SW release 4.0 was built from the internal ADC SW tag BUILD_GRID_SCI 19.

- Once untarred, the directory test_dataset_4.0 contains data of the AGILE 
  Observation Block OB=1000, with starting boresight: L=286.419 B=-1.896 and 
  sky area of 15 degrees radius around the Vela Pulsar.


1. To install the software:

1.1 Donwnload the file:

     - BUILD_GRID_4.0.tgz 
     - test_dataset_4.0.tgz
     - readme_4.0.txt

 1.2 > tar zxvf BUILD_GRID_4.0.tgz
       will create the directory  BUILD_GRID_4.0

 1.3 > create a directory (for example ~/agilesw) and move BUILD_GRID_4.0 in it


2. Set up the environment:

 2.1 After having conveniently replaced root and heasoft installation
     directories with local paths, set environment variables, for bash and csh separately, as follows:

############## settings for bash  
##  external S/W

    export HEADAS=<your-heasoft-install-dir>
    . $HEADAS/headas-init.sh
    export ROOTSYS=<your-root-install-dir>
    PATH=$ROOTSYS/bin:$PATH
    export LD_LIBRARY_PATH=$ROOTSYS/lib:$LD_LIBRARY_PATH

##  AGILE S/W

    export ADC=$HOME/ADC
    export PFILES=$ADC/PFILES:$PFILES
    export PATH=$ADC/scientific_analysis/bin:$PATH
    export AGILE_CFITSIO_INCLUDE=$HEADAS/include
    export AGILE_CFITSIO_LIB=$HEADAS/lib
    export AGILE_CFITSIO_LIBNAME=lcfitsio[_<your-heasoft-libcfitsio-version>]  
(check under $HEADAS/lib/ the libcfitsio file name, e.g. if you find libcfitsio_3.12.so -> export AGILE_CFITSIO_LIBNAME=lcfitsio_3.12)

############## settings for csh, tcsh 
##  external S/W

	setenv HEADAS <your-heasoft-install-dir>
	source $HEADAS/headas-init.csh
	setenv ROOTSYS <your-root-install-dir>
	setenv LD_LIBRARY_PATH $ROOTSYS/lib:$LD_LIBRARY_PATH
	set path=($path $ROOTSYS/bin)

##   AGILE S/W

	setenv ADC $HOME/ADC
	setenv PFILES $ADC/PFILES:${PFILES}
	setenv AGILE_CFITSIO_INCLUDE $HEADAS/include
	setenv AGILE_CFITSIO_LIB $HEADAS/lib
	setenv AGILE_CFITSIO_LIBNAME lcfitsio[_<your-heasoft-libcfitsio-version>]  
(check under $HEADAS/lib/ the libcfitsio file name, e.g. if you find libcfitsio_3.12.so -> setenv AGILE_CFITSIO_LIBNAME lcfitsio_3.12)
	set path=($ADC/scientific_analysis/bin $path )

3. install the build:
    cd BUILD_GRID_4.0
    make install
 This will create in /home/<yourusername> a directory ADC with scientific
 analysis executables.
 Before any subsequent installation, run "make clean" before "make install".

4. Test the software on the test dataset

 4.1  tar zxvf test_dataset_4.0.tgz
      will create the working directory test_dataset_4.0
 4.3  Re-produce COUNTS, EXP and GAS maps (included as examples in the package)
      by following the instructions given in the file test_Delivery4.README

5. Enjoy!