class HTofinoDigitizer: public HReconstructor

_HADES_CLASS_DESCRIPTION


  HTofinofDigitizer digitizes HGeant data, puts output values into
  cal data category
  The input data are read from the HGeantTof category. After calculating
  TOF and Charge of the hit etc the output is stored in the HTofinoCalSim
  category.

   ----------------------                                 -----------
  |   HTofinoCalibrater  |                               | HGeantTof |
  |   (embedding mode)   | \                              -----------
  |                      |  \                                 ||
   ----------------------    \                                || input to digitizer
                              \                               \
                           ---------------    read real     ------------------
                          | HTofinoCalSim | ------------>  | HTofinoDigitizer |
                           ---------------  <-----------   |                  |
                                            write output    ------------------


  In the case of TRACK EMBEDDING of simulated tracks into
  experimental data the real data are written by the HTofinoCalibrater into
  HTofinoCalSim category. The real hits are taken into
  account by the digitizer (adding of charges, sorting by first hit in
  photo multiplier). The embedding mode is recognized
  automatically by analyzing the
  gHades->getEmbeddingMode() flag.
            Mode ==0 means no embedding
                 ==1 realistic embedding (first real or sim hit makes the game)
                 ==2 keep GEANT tracks   (as 1, but GEANT track numbers will always
                     win against real data. besides the tracknumber the output will
                     be the same as in 1)

  The output object HTofinoCalSim contains additional to the tof and
  charge a list of up to 5 tracks hitting the tofino cell. The track numbers
  are stored by increasing tof. In parallel the tof from GEANT is stored in a
  list. In case of embedding the first and second track recieved via getTrack()
  contains real or geant data depending wheater or not there has been a
  embedded track and sim or real was first. In case of no embedded track in the cell
  the list contains only the geant hits.

  tofinocal->getNHit()      number of hits in the cell (val 1-5)
  tofinocal->getTrack(0)    contains real data / geant data (real if real was faster)
  tofinocal->getTrack(1)    contains real data / geant data (sim  if real was faster)
  tofinocal->getTrack(2)    contains geant data
      .
      .
      .
  tofinocal->getTrack(4)    contains geant data

 For the suppression of secondaries produced in the TOF itself there are
 several configuration possibilities:
 They can be switched via setStoreFirstTrack(Int_t flag):
     flag ==  0 realistic (secondaries included)
              1 primary particle is stored
              2 (default) the first track number entering the tof in SAME SECTOR is stored
              3 as 2 but SAME SECTOR && CELL

 To make the influence of the above selections easily visible
 in the output HTofCalSim a debug mode can be switched with
 void   setDebug(Bool_t flag). In this case the track numbers
 affected by the criteria 1-3 will have negative track numbers
 (multiples of -200). The multiplication factor gives the number
 of steps from the start point to the stored track (chain of
 secondaries). In case 1 it is always -200 if a particle has not
 been a primary one.