This commit was generated by cvs2svn to compensate for changes in r2,
[u/mrichter/AliRoot.git] / GEANT321 / gcons / gcons.doc
1 *
2 * $Id$
3 *
4 * $Log$
5 * Revision 1.1.1.1  1995/10/24 10:20:12  cernlib
6 * Geant
7 *
8 *
9 #include "geant321/pilot.h"
10 #if defined(CERNLIB_DOC)
11 *CMZ :  3.21/02 29/03/94  15.41.19  by  S.Giani
12 *-- Author :
13 ************************************************************************
14 *                                                                      *
15 *                   Introduction to the section CONS                   *
16 *                   --------------------------------                   *
17 *                                                                      *
18 *   THE SECTION CONS                                                   *
19 *                                                                      *
20 *  The  experimental   setup  is  represented  by   a  structure  of   *
21 * geometrical volumes.  Each volume is  given a medium number by the   *
22 * user.  Different volumes may have the same medium number [GEOM].     *
23 *  A  medium is  defined  by  a set  of  parameters, the  so>-called   *
24 * 'tracking  medium'  parameters,  which include  reference  to  the   *
25 * material filling the volume.                                         *
26 *  The tracking  of particles  through an experimental  setup [TRAK]   *
27 * requires access to the data which describe                           *
28 *       - the geometrical setup,                                       *
29 *       - the characteristics of the materials used,                   *
30 *       - the tracking medium parameters, and                          *
31 *       - the particle properties.                                     *
32 *  The section CONS contains all routines related to the storage and   *
33 * retrieval of information for the materials, the tracking media and   *
34 * the particles.                                                       *
35 *                                                                      *
36 *   MATERIALS                                                          *
37 *                                                                      *
38 *  The material  constants are  stored in  the data  structure JMATE   *
39 * through  the routine  GMATE which  defines the  standard table  of   *
40 * materials.   They can  be  accessed with  the  routine GFMATE  and   *
41 * printed with the routine GPMATE.                                     *
42 *  GMATE calls  the routine GSMATE  for each material in  turn.  The   *
43 * user may directly use GSMATE instead  of, or in addition to, or to   *
44 * partly override, GMATE.                                              *
45 *  MIXTUREs of  basic materials, or COMPOUNDs,  molecules with atoms   *
46 * from  different basic  materials, may  also be  defined and  their   *
47 * characteristics  can be  stored  in the  structure JMATE,  through   *
48 * calls  to the  routine  GSMIXT.  Mixtures  of  compounds are  also   *
49 * accepted.                                                            *
50 *  In addition,  some quantities computed during  the initialisation   *
51 * of the physics processes are stored  in the structure JMATE , such   *
52 * as energy loss and cross>-section tables [PHYS].                     *
53 *                                                                      *
54 * TRACKING MEDIUM PARAMETERS                                           *
55 *                                                                      *
56 *  For  each medium  in  turn, the  tracking  medium parameters  are   *
57 * stored in  the data  structure JTMED  through the  routine GSTMED.   *
58 * Details about these  parameters are given in [TRAK].   They can be   *
59 * accessed  with the  routine GFTMED  and printed  with the  routine   *
60 * GPTMED.                                                              *
61 *  The correct setting  of the tracking media  parameters is crucial   *
62 * for the  correctness of the  results of the simulation.   In GEANT   *
63 * some  of  these parameters  are  calculated  automatically by  the   *
64 * program by default.  This can be  disabled by the data record AUTO   *
65 * 0, but only experienced users should use this option.                *
66 *  The tracking cuts,  the physics cuts and the  flags which control   *
67 * the physics processes, defined in  GINIT and possibly modified via   *
68 * the relevant data  cards, are also stored in  the structure JTMED.   *
69 * Any of  these additional  parameters can  be modified  through the   *
70 * routine GSTPAR.                                                      *
71 *                                                                      *
72 * PARTICLES                                                            *
73 *                                                                      *
74 *  The particle  constants are  stored in  the data  structure JPART   *
75 * through  the routine  GPART which  defines the  standard table  of   *
76 * particles and, if relevant, the  branching ratios and decay modes.   *
77 *  The standard particle constants can  be accessed with the routine   *
78 * GFPART and printed with the routine GPPART.                          *
79 *  GPART calls the routine GSPART (and GSDK for the decays) for each   *
80 * particle  in turn.   The user  may call  directly GSPART  and GSDK   *
81 * instead of, or in addition to, or to partly override, GPART.         *
82 *                                                                      *
83 ************************************************************************
84 #endif