******************************************************
*	
* 	HOW TO INSTALL PGS.
*	25 june 2001.
* 	A.Besson, Y.Arnoud.
******************************************************
1/ download: CERN.tar.gz and NEWPGS.tar.gz
- gunzip CERN.tar.gz;
- gunzip NEWPGS.tar.gz;
- tar -xvf NEWPGS.tar;
- tar -xvf CERN.tar;
- cd NEWPGS;
- Modify the Makefile to link with the libraries.
- gmake all;

******************************************************
*   MAIN MODIFICATIONS compared to the official version of PGS.
******************************************************
The directory structure is different. 
       
Susygen is also interfaced with PGS.
       	
A Makefile compiles 5 executables,
	pgs_herwig.exe, pgs_isajet.exe, pgs_pythia.exe,
       	pgs_singles.exe, pgs_susygen.exe.
       
The input parameters of PGS are read by an input file. 
       (this has been done before PGS replaced SHW)
       
The calorimeter resolution has been modified.
       	
Some kumac and fortran files have been added fot ntuple analysis.
       
Some scripts have been added to generate susygen/isajet
	 scans for MSUGRA.


******************************************************
* 	SCRIPTS, DIRECTORIES AND ALL THAT.
******************************************************
0/  D0PROD/NEWPGS
main directory containing include files of pgs
and the Makefile. You compile here.

the commands available:

gmake clean: delete .o , .exe, .~, .ntp.
gmake pgs_susygen.exe
gmake pgs_pythia.exe
gmake pgs_isajet.exe
gmake pgs_herwig.exe
gmake pgs_singles.exe
gmake all

1/ D0PROD/NEWPGS/SOURCE directory containing source files of pgs

2/  D0PROD/NEWPGS/SUSYGEN  susygen source files.

3/ D0PROD/NEWPGS/INPUTPGS In this directory, I added all the stuffs concerning
 the input parameters of PGS. 
-> just modify pgs.input in the D0PROD/NEWPGS/INPUTSG directory.

4/ D0PROD/NEWPGS/HERWIG herwig source files.

5/ D0PROD/NEWPGS/ISAJET some files needed by isajet.

6/ D0PROD/NEWPGS/JOBS the place to run your jobs.
*contains script files:

runis (isajet+pgs)
runpy (pythia+pgs)
runsg (susygen+pgs)
perli_input (susygen+pgs+scan over the SUGRA parameters)
runsin (singles+pgs)

*contains data cards
commands.isa (isajet input card)
isadecay.dat (isajet decay table)
pgs.input (pgs input card)
pgs_pythia_cards (pythia input card)
susygen.input (susygen input card)
pdg_mass.tbl
sugra_pt2.in (ISAWIG output for HERWIG)

*contains links to executables (all the *.exe)
pgs_herwig.exe
pgs_isajet.exe
pgs_pythia.exe
pgs_susygen.exe
pgs_singles.exe

*contains output files.
SUSPECT.out (suspect spectrum)
isajet.list (isajet)
isajet.out (isajet)
susygen.ntp (susygen ntuple for cross sections)
susygen.dat (susygen output with sugras params, masses, cross-sections)
pgs.ntp (reconstructed events ntuple with PGS)


6/ D0PROD/NEWPGS/JOBS/RESULTS
When you run pgs_susygen.exe with the script perli_input
The numbers in the file names are the SUGRA parameters:
susygen***.dat (susygen.dat)
pgs***.ntp
SUSPECT***.out
susygen***.input

7/ D0PROD/NEWPGS/ANALYSE
contains analyse script for pgs_susygen.

* analyse.sh script. calls analyseperl wich reads all the susuygen.dat
 in  D0PROD/NEWPGS/JOBS/RESULTS
(modify the loop in the script if necessary), and makes a readable file
"sigma.dat" ready to be read by makentp.kumac.

* analyseperl: perl scipt called by analyse.sh

* makentp.kumac : kumac to run with paw to make a ntuple with SUGRA params,
 SUSY masses, cross-sections.

8/ D0PROD/NEWPGS/JOBS/RESULTS_Background/
contains kumac to analyze the PGS ntuple.

*loop.f : fortran file for the nt/loop stuff.
*main.kumac, main2.kumac main3.kumac : kumac to read all the background and signal ntuple.