+-------------+ +----------##
| Geant 3.15 | GEANT User's Guide | BASE040 ##
+-------------+ +----------##
Author(s) : F.Bruyant, M.Maire Submitted: 01.10.84
Origin : GEANT2/3 Revised: 10.01.92
Introduction
GEANT3 uses the FFREAD [bib-FFREAD] package to read `free
format' data records in the routine
GFFGO. The records currently
interpreted by GFFGO can be
classified into five categories:
- General control of the run.
- Control of the physics processes.
- Debug and I/O operations.
- User applications.
- Lund event generation.
The data records are listed below by category with the following
information:
- KEY
- keyword, any number of characters truncated to
the first 4 unless otherwise specified by the user
- N
- maximum expected number of variables NVAR
- T
- type of these variables (I=INTEGER, R=REAL or
M=MIXED) and for each variable in turn:
- VAR..., FORTRAN name
- Short description (more detail in [BASE030])
- Labelled COMMON where it is stored, and
- Default value usually from
GINIT.
When a record is decoded, the values entered by the user without explicit
assignment are assigned to the variables in order. The number of values
can be less than NVAR. In case of a MIXED type the values entered have to
be in agreement with the default of the corresponding FORTRAN variable
names.
Example of data record : RUNG 5 201
to preset the current run and event number to 5 and 201 respectively. In
batch jobs there is no need for any special termination record and none of
the records mentioned below is mandatory.
User defined data records
Before calling GFFGO the user may
define private data records through calls to
FFKEY as follows:
CALL FFKEY('KEY',VAR(1),NVAR,'TYPE')
They will be interpreted by GFFGO
in the same way as the standard records.
Summary of GEANT3 Data Cards
General control of the run
KEY N I VAR Short description COMMON GINIT
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
HSTA 20 M LHSTA Names of required standard histograms /GCLIST/ Blank
[BASE110]
PATR 4 I NJTMAX /GCSTAK/ 0
NJTMIN /GCSTAK/ 0
NTSTKP /GCSTAK/ 500
NTSTKS /GCSTAK/ 100
RNDM 2 I NRNDM Initial random number seed (2 words) /GCFLAG/ 0
RUNG 2 I IDRUN User run number /GCFLAG/ 1
IDEVT First user event number /GCFLAG/ 1
TRIG 1 I NEVENT Total number of events to process /GCFLAG/ 10000000
TIME 3 M TIMINT Time left after initialisation /GCTIME/
TIMEND Time required for termination /GCTIME/ 1
ITIME Test every ITIME events /GCTIME/ 1
Control of physics processes [PHYS 001]:
--KEY-----N-----I----VAR-------Short-description---------------------------COMMON-------------------------------------------------------GINIT---
ANNI 1 I IANNI Annihilation flag /GCPHYS/ 1
BREM 1 I IBREM Bremsstrahlung flag /GCPHYS/ 1
COMP 1 I ICOMP Compton scattering flag /GCPHYS/ 1
CUTS 16 R Kinetic energy cuts:
CUTGAM cut for for gammas /GCCUTS/ 0.001
CUTELE cut for electrons /GCCUTS/ 0.001
CUTNEU cut for neutral hadrons /GCCUTS/ 0.01
CUTHAD cut for charged hadrons /GCCUTS/ 0.01
CUTMUO cut for muons /GCCUTS/ 0.01
BCUTE cut for electron Bremsstrahlung /GCCUTS/ GUTGAM
BCUTM cut for muon and hadron Brems. /GCCUTS/ CUTGAM
4
DCUTE cut for delta rays by electrons /GCCUTS/ 10
4/
DCUTM cut for delta rays by muons /GCCUTS/ 10
PPCUTM Total energy cut for pair prod. by muons /GCCUTS/ 0.01
10
TOFMAX Time of flight cut /GCCUTS/ 10
GCUTS 5 user words /GCCUTS/ 0.
KEY N I VAR Short description COMMON GINIT
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
DCAY 1 I IDCAY Decay flag /GCPHYS/ 1
DRAY 1 I IDRAY Delta ray flag /GCPHYS/ 1
ERAN 3 M Cross section tables:
-5/
R EKMIN Minimum energy for the cross section tables /GCMULO/ 10
4/
R EKMAX Maximum energy for the cross section tables /GCMULO/ 10
I NEKBIN Number of bins for cross section tables /GCMULO/ 90
HADR 1 I IHADR Hadronic process flag /GCPHYS/ 1
LOSS 1 I ILOSS Energy loss flag (See Note below) /GCPHYS/ 2
MULS 1 I IMULS Multiple scattering flag /GCPHYS/ 1
MUNU 1 I IMUNU Muon nuclear interaction flag /GCPHYS/ 1
PAIR 1 I IPAIR Pair production flag /GCPHYS/ 1
PFIS 1 I IPFIS Photofission flag /GCPHYS/ 0
PHOT 1 I IPHOT Photo electric effect flag /GCPHYS/ 1
RAYL 1 I IRAYL Rayleigh scattering flag /GCPHYS/ 0
Debug and I/O operations:
KEY N I VAR Short description COMMON GINIT
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
DEBU 3 M IDEMIN First event to debug. If negative, /GCFLAG/ 0
IDEBUG is set for the initialisation phase
IDEMAX Last event to debug /GCFLAG/ 0
ITEST Print control frequency /GCFLAG/ 0
GET 20 M LGET Names of data structures to fetch /GCLIST/ Blank
PRIN 20 M LPRIN User keywords to print data structure /GCLIST/ Blank
RGET 20 M LRGET Names of data structures to fetch (RZ) /GCRZ/ Blank
RSAV 10 M LRSAVE Names of data structures to save (RZ) /GCRZ/ Blank
SAVE 20 M LSAVE Names of data structures to save /GCLIST/ Blank
SWIT 10 I ISWIT User flags for debug /GCFLAG/ 0
Note: all the names quoted here are given as 4 characters names in input
and their ASCII equivalent is read into the correspoding variable.
User applications:
KEY N I VAR Short description COMMON GINIT
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
KINE 11 M IKINE User flag /GCKINE/ 0
10
PKINE 10 user words /GCKINE/ 10
SETS 20 M LSETS User words for detector sets /GCLIST/ Blank
STAT 20 M LSTAT User words to control statistics. /GCLIST/ Blank
LSTAT(1) reserved for system use.
PLOT 20 M LPLOT User words to control plots /GCLIST/ Blank
GEOM 20 M LGEOM User words to control geom setup /GCLIST/ Blank
VIEW 20 M LVIEW User words to control view banks /GCLIST/ Blank
Lund event generation:
--KEY-----N------I----VAR-------Short-description---------------------------------------------------------------COMMON-------------------------------------------------------GINIT---
MSTE 20 I MSTE See /GLUNDI/ code LUDATE
KTYP 120 I KTYP See /GLUNDI/ code LUDAT2
PMAS 120 R PMAS See /GLUNDI/ code LUDAT2
PWID 60 R PWID See /GLUNDI/ code LUDAT2
IDB 120 I IDB See /GLUNDI/ code LUDAT3
LUND 2 M IFLUND Flavour code (See /GCLUND/ 0
R ECLUND Total CMS energy /GCLUND/ 94
Landau fluctuations versus delta rays
In order to avoid double counting between Landau fluctuations ILOSS=2) and
explicit delta ray generation (IDRAY=1), an automatic protection is put in
GEANT3: if ILOSS = 2 the default value for delta ray generation cannot be
changed. The different cases are summarized in the table below.
+---------+---------------------------------------------------------
| | | | |
| | Full Landau | Restricted Landau | No fluctuations |
| | ILOSS = 2 (D) | ILOSS = 1 or 3 | ILOSS = 4 |
+---------+----------------+--------------------+------------------+
| | | | |
| IDRAY | 0 | 1 | 1 |
| DCUTE | 10 TeV | CUTELE | CUTELE |
+-DCUTM---+-10-TeV---------+-CUTELE-------------+-CUTELE-----------+
| |
| |