AGILE SW Package:  AGILE_SW_6.0_SourceCode
(Agile Data Center, 15-03-2019)

The AGILE mission is providing a suite of tools called the 
AGILE Science Tools for the analysis of GRID data. 
The suite is developed by the AGILE Team.
This public software package is adapted from 
the AGILE Science Tools (TAGNAME = BUILD25) and 
distributed by ASI/SSDC. 

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

- BUILD_GRID_6.0.tgz ( ~ 1.1 GB)
- test_dataset_6.0.tgz ( ~ 600 MB ) 
- readme_6.0.txt

Note: This new AGILE scientific s/w runs ONLY on 64-bit processors.

1. External software requirements:

- ROOT    available from https://root.cern.ch/
- CFITSIO available from https://heasarc.gsfc.nasa.gov/fitsio/

Users have to install the required external software on their computers.

2. To install the AGILE software:

- Download the files and untar the packages:

  - BUILD_GRID_6.0.tgz 
  - test_dataset_6.0.tgz
  - readme_6.0.txt

- Set up the environment:

  We need 3 environment variables to compile the core 
  of the AGILE Science Tools. 

  After having conveniently installed and/or checked the 
  external software, set environment variables as explained below for 
  the bash or the csh shell separately.

############## settings for bash shell

  export CFITSIO=<path-to-your-installation> 
  export ROOTSYS=<path-to-your-installation>
  export AGILE=<path-to-AGILE-installation>  (for example $HOME/AGILE) 

  Note: You can change the destination directory by setting a 
  different $AGILE environment variable.

  The following variables are also needed to run the code of the 
  AGILE Science Tools:

  export PFILES=$PFILES:$AGILE/share
  export LD_LIBRARY_PATH=$AGILE/lib:$LD_LIBRARY_PATH
  export PATH=$AGILE/bin:$PATH

############## settings for csh/tcsh shell

  setenv CFITSIO <path-to-your-installation> 
  setenv ROOTSYS <path-to-your-installation>
  setenv AGILE <path-to-AGILE-installation> 

  setenv PFILES ${PFILES}:$AGILE/share
  setenv LD_LIBRARY_PATH $AGILE/lib:$LD_LIBRARY_PATH
  setenv PATH $AGILE/bin:$PATH


- Install the build:
  
  cd BUILD_GRID_6.0/
  Run the bash-shell scripts:
  ./installScienceTools.sh
  ./installIRF.sh

 
- To recompile the code:

  ./installScienceTools.sh clean
  ./installScienceTools.sh


********************************************

Notes: 

- Users with pre-installed HEADAS software package may 
simply define: 

export CFITSIO=$HEADAS (for bash shell)
setenv CFITSIO $HEADAS (for csh/tcsh shell)

- $LD_LIBRARY_PATH must include $ROOTSYS/lib

- $PATH must include $ROOTSYS/bin