bank_ftrm


    FTRM Through-going Muon Monte Carlo Summary bank.  One for each Monte Carlo event
    ===================================================================================
 
    Contact:  C. Kyba, Penn
 
    Revision History:-
    ================
 
    5.01  C. Kyba      First version.
 

 
Description
-----------
 
    This bank contains Monte Carlo information about the generated muon 
and a mask which indicates which particles were produced as the muon 
travelled through SNO.  This bank should only be checked when running 
single muons in SNO (ie. there is no support for multiple generated 
muons).
 
 
Reference Links
---------------
 
    No extensions.
 
 
Structural Links
----------------
 
    No extensions.
 
 
Status Bits
-----------
 
Note: Any status bit parameters are defined to work with bit functions such as
      IAND and BTEST.
 
 
Data Words
----------
 
 
    Data types: B(bit), I, F, D(double), H(hollerith 4 char)
 
 +1  F KFTRM_GEN_DIR_U     MC Muon generated X direction cosine
 +2  F KFTRM_GEN_DIR_V     MC Muon generated Y direction cosine
 +3  F KFTRM_GEN_DIR_W     MC Muon generated Z direction cosine
 +4  F KFTRM_GEN_POS_X     MC Muon generated X position
 +5  F KFTRM_GEN_POS_Y     MC Muon generated Y position
 +6  F KFTRM_GEN_POS_Z     MC Muon generated Z position
 +7  F KFTRM_ENT_POS_X     MC Muon entrance X position
 +8  F KFTRM_ENT_POS_Y     MC Muon entrance Y position
 +9  F KFTRM_ENT_POS_Z     MC Muon entrance Z position
 +10 F KFTRM_EXIT_POS_X    MC Muon exit X position
 +11 F KFTRM_EXIT_POS_Y    MC Muon exit Y position
 +12 F KFTRM_EXIT_POS_Z    MC Muon exit Z position
 +13 F KFTRM_STOP_POS_X    MC Muon stopping X position
 +14 F KFTRM_STOP_POS_Y    MC Muon stopping Y position
 +15 F KFTRM_STOP_POS_Z    MC Muon stopping Z position
 +16 F KFTRM_MU_ENE        MC Muon starting energy (see Note 1.)
 +17 F KFTRM_GEN_IMPACT    MC Muon impact parameter
 +18 I KFTRM_MU_MASK       MC Muon type bit mask
          Bit  Mnemonic                  Meaning if Set
           0   FTR_GEN_MU_FLAVOR         Generated muon is a mu+, otherwise mu-
           1   FTR_TG                    Muon is Throughgoing
           2   FTR_STOP                  Muon stopped in detector
           3   FTR_PC                    Muon is partially contained
           4   FTR_FC                    Muon is fully contained
           5   FTR_ENTERED               Muon entered detector
           6   FTR_EXITED                Muon exited detector

 +19 I KFTRM_PART_MASK     MC Muon produced particle mask
          Bit  Mnemonic                  Meaning if Set
           0   FTR_PART_GAMMA            At least one gamma was produced
           1   FTR_PART_E_MINUS          At least one electron was produced
           2   FTR_PART_E_PLUS           At least one positron was produced
           3   FTR_PART_MU_MINUS         At least one mu- was produced
           4   FTR_PART_MU_PLUS          At least one mu+ was produced
           5   FTR_PART_TAU_MINUS        At least one tau- was produced
           6   FTR_PART_TAU_PLUS         At least one tau+ was produced
           7   FTR_PART_PIO              At least one neutral pion was produced
           8   FTR_PART_PI_MINUS         At least one pi- was produced
           9   FTR_PART_PI_PLUS          At least one pi+ was produced
          10   FTR_PART_ETA              At least one eta was produced
          11   FTR_PART_ETA_BAR          At least one eta bar was produced
          12   FTR_PART_K_SHORT          At least one k short was produced
          13   FTR_PART_K_LONG           At least one k long was produced
          14   FTR_PART_K_MINUS          At least one k- was produced
          15   FTR_PART_K_PLUS           At least one k+ was produced
          16   FTR_PART_K_ZERO           At least one k0 was produced
          17   FTR_PART_K_ZERO_BAR       At least one k0bar was produced
          18   FTR_PART_PROTON           At least one proton was produced
          19   FTR_PART_NEUTRON          At least one neutron was produced
          20   FTR_PART_ANTIPROTON       At least one antiproton was produced
          21   FTR_PART_ANTINEUTRON      At least one antineutron was produced
          22   FTR_PART_DEUTERON         At least one deuteron was produced
          23   FTR_PART_ALPHA            At least one alpha was produced
          24   FTR_PART_TRITON           At least one triton was produced
          25   FTR_PART_EXOTIC1          At least one particle with id between 
                                         56 and 75 was produced (see id_particles.inc)
          26   FTR_PART_EXOTIC2          At least one particle with id between 
                                         84 and 116 was produced (see id_particles.inc)
 +20 F KFTRM_DEDX          MC Muon rate of energy loss (MeV/m) (see Note 2.)
 +21 F KFTRM_AVE_IMPACT    MC point of closest approach to SNO center defined by a line from entrance to exit
 +22 F KFTRM_SPARE2        Spare
 +23 F KFTRM_SPARE2        Spare


1)  This is not the actual generation energy, but instead the energy at the
    end of the first vertex.  If it is ever necessary to update get the true
    generation energy it is suggested that a word be added to bank_mcgn.


2)  This is the energy lost between the first vertex inside of 850cm and the
    first vertex outside of 850cm, divided by the distance between the two
    vertices.  If the muon starts inside the detector then the first vertex is 
    the generation vertex, and if the muon stops inside the detector then the
    second vertex is the final muon vertex.


Go Back to the Snoman Companion Top Page