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

AGILE Guest Observer Package:  AGILE_GO_3.0_SourceCode
Agile Data Center (ADC), 21-05-2009

The package AGILE_GO_3.0_SourceCode contains 4 files:
two .tgz files, one .gz file plus this readme file:

- GO_BUILD_GRID_3.0.tgz ( ~ 260 M)    
- GO_test_dataset.tgz ( < 1M ) 
- AO1_OB1000_r2.LOG__GO.gz ( ~ 840 M)
- readme.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 GO_BUILD_GRID 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-18.pdf).
  The current version of the software delivered for this Release 3.0
  to Guest Observers reflects the current best understanding and
  testing of calibrations, background rejection, and processing results.
  The GO release 3.0 was built from the internal ADC SW tag BUILD GRID SCI 18.

- Once untarred, the directory GO_test_dataset contains a test data set which
  includes about 50 orbits of data referring to the AGILE observation period:
  start= 2007-07-17 09:10 end= 2007-07-20 23:40
  This data set is part of the AGILE Observation Block OB=1000, with starting
  boresight: L=286.419 B=-1.896 and it concerns an area of 15 degrees radius
  around the Vela Pulsar.

- The AO1_OB1000_r2.LOG__GO.gz file need not to be unzipped. It contains all spacecraft
  information necessary for data analysis. 

1. To install the software:

1.1 Donwnload the file:

     - GO_BUILD_GRID_3.0.tgz ( ~ 260 M)    
     - GO_test_dataset.tgz ( < 1M ) 
     - AO1_OB1000_r2.LOG__GO.gz ( ~ 840 M)
     - readme.txt ( ~ 4 K)

 1.2 > tar zxvf GO_BUILD_GRID_3.0.tgz
       will create the directory GO_BUILD_GRID

 1.3 > create a directory (for example ~/agilesw) and move GO_BUILD_GRID.tgz 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=$PATH:$ROOTSYS/bin
    export LD_LIBRARY_PATH=$ROOTSYS/lib:$LD_LIBRARY_PATH

##  AGILE S/W

    export ADC=$HOME/ADC
    export PFILES=$PFILES:$ADC/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 ${PFILES}:$ADC/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 GO_BUILD_GRID
    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 data set

 4.1  tar zxvf GO_test_dataset.tgz
      will create the working directory GO_test_dataset
 4.2  move the AO1_OB1000_r2.LOG__GO.gz file in the working directory GO_test_dataset
 4.3  Re-produce COUNTS, EXP and GAS maps (included as examples in the package)
      by following the instructions given in the file GOtest_Delivery3.README

5. Enjoy!