Handling Sensitive DETector Hit parameters

+-------------+                                               +----------##
| Geant 3.10  |               GEANT User's Guide              | HITS110  ##
+-------------+                                               +----------##
                                   

                                   

Author(s) : R.Brun                                     Submitted: 01.11.83
Origin    : Same                                         Revised: 14.05.86
                                  

+------------------------------------------------------------------------+
|CALL GSDETH (IUSET,IUDET,NH,NAMESH,NBITSH,ORIG,FACT) |
+------------------------------------------------------------------------+

Defines hit parameters for detector IUDET of set IUSET.

IUSET
user set identifier
IUDET
user detector identifier
NH
number of elements per hit
NAMESH
the NH variable names for the hit elements
NBITSH
the NH bit numbers for packing the variable values
ORIG
The quantity packed in the structure JHITS for the Ith variable is a positive integer with NBITSH(I) bits and such that
FACT
IVAR(I) = (VAR(I)+ORIG(I))*FACT(I)

The routine is used at initialisation time once the geometrical volumes have been defined to describe the hit elements and the way to do packing in memory and on tape. 

                                 EXAMPLE
Assume an electromagnetic calorimeter ECAL divided into 40 PHI sections called EPHI.Each EPHI division is again divided along the Z axis in 60 objects called EZRI. Each EZRI is finally divided into 4 lead glass blocks called BLOC. The geometrical information to describe one hit will then be: 

                                   
    
                The EPHI section number (between 1 and 40)
               The EZRI division number (between 1 and 60)
                         The BLOC number (1 to 4)

The variables we want to store for each hit are for example:

X
x position of the hit in the lead glass block
Y
y
Z
z
E
energy of the particle at this point
ELOS
the energy deposited into this block

Example of one hit in that scheme: 

      EPHI 12
      EZRI 41
      BLOC  3
       X    7.89 cm
       Y    -345.6 cm
       Z    1234.8 cm
       E    12 Gev
       ELOS  11.85 Gev

The FORTRAN coding to define the set/det/hits information could be: 

  DIMENSION NAMESV(3),NBITSV(3)
  DIMENSION NAMESH(5),NBITSH(5),ORIG(5),FACT(5)
  DATA NAMESV/'EPHI','EZRI','BLOC'/
  DATA NBITSV/6,6,3/
  DATA NAMESH/'X   ','Y   ','Z   ','E   ','ELOS'/
  DATA NBITSH/5*16/
  DATA ORIG/3*1000.,0.,0./
  DATA FACT/3*10.,2*100./
      CALL GSDET ('ECAL','BLOC',3,NAMESV,NBITSV,2,100,100,
     +                         ISET,IDET)
      CALL GSDETH('ECAL','BLOC',5,NAMESH,NBITSH,ORIG,FACT)


+-----------------------------------------------------------------------------+
|CALL GFDETH (IUSET,IUDET,NH*,NAMESH*,NBITSH*,ORIG*,FACT*) |
+-----------------------------------------------------------------------------+

Returns the hit parameters for detector IUDET of set IUSET. All arguments are explained above.