*
* $Id$
*
* $Log$
*
* This directory was created from gpamela.car patch _inform
*CMZ :  2.01/00 05/04/2000  14.35.18  by  Marialuigia Ambriola
*CMZ :  3.00/00 08/02/2002  17.33.00  by  Unknown
*CMZ :  2.03/00 06/11/2000  01.40.19  by  Francesco Cafagna
*CMZ :  2.02/00 12/10/2000  16.03.56  by  Francesco Cafagna
*CMZU:  2.01/00 05/04/2000  09.51.03  by  Unknown
*CMZ :  2.00/00 03/03/2000  15.33.44  by  Francesco Cafagna
*CMZ :  1.02/00 25/01/2000  18.22.29  by  Francesco Cafagna
*CMZ :  1.01/01 23/05/96  17.11.59  by  Francesco Cafagna
*CMZ :  1.01/00 22/05/96  09.46.03  by  Francesco Cafagna
*CMZ :  1.00/03 30/04/96  17.40.07  by  Francesco Cafagna
*CMZ :  1.00/02 03/04/96  18.23.50  by  Francesco Cafagna
*CMZ :  1.00/01 28/11/95  18.54.38  by  Francesco Cafagna
*-- Author :    Francesco Cafagna   28/11/95

 GPAMELA: A GEANT based montecarlo of PAMELA

   This CMZ file contains:
     A.patchy $VERSION  , with the version in use
     B.patchy $HISTORY  , general comments on changes and implementations
     C.patchy $INFORM   , infos on patchy and flag to be used in the program
     D.patchy $KUMACS   , collection of CMZ kumacs
     E.patchy $MANUAL   , LaTeX version of the program user guide
     E.patchy *GPAMELA  , pilot patchy with the +USE directives
     F.patchy GPCDES    , patchy with common definitions
     G.patchy GPAMELA   , main patchy with the general routines
     H.patchy GPTOF     , patchy with specific TOF routines
     I.patchy GPTRD     , patchy with specific TRD routines
     L.patchy GPCALO    , patchy with specific CALO routines
     M.patchy GPSPEC    , patchy with specific SPECTROMETER routines
     N.patchy GPFIELD   , patchy with specific MAGNETIC FIELD routines
     O.patchy GPHYS     , patchy with specific PHYSics routines
     P.patchy GPOBSOLETE, patchy with routines declared obsolete
     Q.patchy GPGAR     , patchy with GARFIELD interface routines

   Flags used:
     INTER   , To select interactive version option.
     DEB     , To select the same option of INTER in GUKINE without the full
               interactive version options.
     HIGZ    , To select HIGZ related code.
     X11     , To select X11 version
     PP      , To select ++ version
     MAGNET  , To select magnetic field correction in spectrometer digits.

     TYPE    , Used in GEANT GCDES to explicit declare the variable type.
     SINGLE  , Used in GEANT GCDES to select single precision
     INCLUDE , Used in GEANT GCDES
     NOGFLUCT, To select Gaussian straggling calculation inside the GPUCAL
               and GPUSPE routines instead that the GFLUCT one.
     GARFIELD, To select GARFIELD interface
     MANYWIRE, LONGLIST, BIGMAP, To be used with GARFIELD

   For the use of fluka as hadronic process simulation program the file
   FLUKAAF.DAT is necessary. For this reason the CERN_ROOT environment
   variable has to be added in the file .login with the value /cern/pro.


   DATA CARDS definition and usage. If not specified you can use DATA CARDS
   options in any order.

+--------------+----------------------+---------------------------------------+
| DATA CARD    | USAGE                | ACTION                                |
+--------------+----------------------+---------------------------------------+
| MAGN         | 1 or 2 or 3          | Select magnetic field type. 1 is the  |
|              |                      | strongly inhomogeneus case,           |
|              |                      | GPFIELD.MAP is required               |
|              |                      |                                       |
| NDET         |        'TOF ' 'TRD ' | Do not simulate the selected          |
|              | 'SPE ' 'CAL ' 'CAT ' | detectors                             |
|              | 'CAS ' 'SPHE'        |                                       |
|              |                      |                                       |
| CAS          | 'NVOL' 'NPHY' 'NHBK' | Disable CAS volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| CAT          | 'NVOL' 'NPHY' 'NHBK' | Disable CAT volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| TOF          | 'NVOL' 'NPHY' 'NHBK' | Disable TOF volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| TRD          | 'NVOL' 'NPHY' 'NHBK' | Disable TRD volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| SPE          | 'NVOL' 'NPHY' 'NHBK' | Disable SPE volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| CAL          | 'NVOL' 'NPHY' 'NHBK' | Disable CAL volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| S4           | 'NVOL' 'NPHY' 'NHBK' | Disable S4  volume simulation, as NDET|
|              |                      | or physics, i.e. SET DET or hits, or  |
|              |                      | n-tple definition.                    |
|              |                      |                                       |
| HCWN         | 1                    | Enable CWN-tple                       |
|              |                      |                                       |
| HLON         | 1                    | Select CWN long format                |
|              |                      |                                       |
| NCPL         | 44 integers 1<=n<=44 | Exclude the listed calorimeter silicon|
|              | Ex.: 1 33 6 12 31=10 | plane from the simulation             |
|              |                      |                                       |
| NCSI         |  9 integers 1<=n<=9  | Exclude the listed calorimeter silicon|
|              | Ex.: 1 3=9 6 5=4     | detectors from any calorimeter plane  |
|              |                      |                                       |
|              |                      |                                       |
| NCAB         | 22 integers 1<=n<=22 | Exclude the listed calorimeter        |
|              | Ex.: 4=22 20 7 11=2  | absorber planes from the simulation   |
|              |                      |                                       |
| CALO         | 'NOWn'               | Use 'n' planes without tungsten       |
|              |                      |                                       |
| SPTM         | 'SICA' 'W   ' 'SITR' | Enable Special Tracking Parameter for |
|              | 'SITR' 'XE  ' 'SCIN' | selected tracking media               |
|              | 'TRAD' 'FE  ' 'KAP ' | To obtain the correct energy value for|
|              | 'N2G ' 'G10 ' 'AL  ' | the calorimeter, "SICA","G10C","W2  ' |
|              | 'AER ' 'ROA ' 'CE  ' | and "CE  " MUST be enabled.           |
|              | 'W2  ' 'G10C'        |                                       |
|              |                      |                                       |
| HPAK         | 'FLUK'               | To select FLUKA as hadronic process   |
|              |                      | simulation programn.                  |
|              |                      |                                       |
| AUTM         | 'TMAX' 'STMA' 'DEEM' | Force AUTO calculation for specified  |
|              | 'EPSI' 'STMI'        | parameters, regardless of AUTO data   |
|              |                      | card value                            |
|              |                      |                                       |
| TMAX         | Any real number      | Pass TMAXFD tracking parameter value  |
|              |                      |                                       |
| STMA         | Any real number      | Pass STEMAX tracking parameter value  |
|              |                      |                                       |
| DEEM         | Any real number      | Pass DEEMAX tracking parameter value  |
|              |                      |                                       |
| EPSI         | Any real number      | Pass EPSIL  tracking parameter value  |
|              |                      |                                       |
| STMI         | Any real number      | Pass STMIN  tracking parameter value  |
|              |                      |                                       |
| TPAL         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for aluminum                    |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TG10         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for G10                         |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| T10C         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for calorimeter G10C            |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPN2         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for nitrogen gas                |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPW          | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for tungsten                    |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPW2         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for calorimeter tungsten mix    |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPKA         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for kapton                      |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPFE         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for iron                        |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TRAD         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for TRD radiator                |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPRO         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for roacell                     |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPCF         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for carbon fibers               |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPSC         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for scintillator                |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TSCA         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for silicon (calorimeter)       |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TSTR         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for silicon (tracker)           |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPXE         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for Xenon                       |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPAE         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for aerogel                     |
|              | 5=STMIN              |                                       |
|              |                      |                                       |
| TPCE         | 1=TMAXFD 2=STEMAX    | Pass TMAXFD, STEMAX,DEEMAX, EPSIL and |
|              | 3=DEEMAX 4=EPSIL     | STMIN for kaolinite (calorimeter      |
|              | 5=STMIN              | insulator)                            |
|              |                      |                                       |
| *HBFI        | 11 'HB$REF:GP.HIS'   | To define user LUNIT and name         |
|              |                      | HBOOK file. (Max 80 characters )      |
|              |                      |                                       |
| *GAFI        | 12 'FILENAME.GAR'    | To define user LUNIT and name         |
|              |                      | for GARFIELD file.(Max 80 characters) |
|              |                      |                                       |
| STTR         | 1=1 2=D2SICA 3=D2SITR| Force gussian straggling just for     |
|              |                      | silicon in GFLUCT. D2SICA & D2SITR are|
|              |                      | the parameter to be passed to the     |
|              |                      | gaussian generator.                   |
|              |                      |                                       |
| DZSH         | Any real number with | Height adjustment for external shell  |
|              | Sign                 |                                       |
|              |                      |                                       |
| GEN          | XGEN, YGEN, ZGEN,    | Pass the coordinates of the origin and|
|              | XDGEN, YDGEN         | the dimensions of the generation      |
|              |                      | surface.                              |
|              |                      |                                       |
| PHI          | PHGEN(1), PHGEN(2)   | Define the minimum and the maximum    |
|              |                      | azimuth. Default values are:          |
|              |                      | 0., 360.                              |
|              |                      |                                       |
| THET         | THGEN(1), THGEN(2)   | Define the minimum and the maximum    |
|              |                      | zenith. Default values are:           |
|              |                      | 0., 90.                               |
+--------------+----------------------+---------------------------------------+

NOTE: To process a large number of events in batch mode, on Linux
   system, the Geant data card TIME must be used. It is necessary to set
   ITIME < 0.  This will force no check on the CPU time left to end the
   program. For some reason it terminates the program also if no TIME
   card is used.
