bank_pin

   PIN   ZDAB PMT Crate Card Channel for all PMT hits.  One for each event.
   ========================================================================
 
    Contact:  R.G. Van de Water (Penn).
 
    Revision History:-
    ================
 
    2.07  R. Van de Water,     First version.
    3.01  N. West              Now Card Crate Channel after uncalibration.


 
Description
-----------
 
    A set of CCC (Crate Card Channel) numbers for the list of ZDAB Calibration 
    PMT hits of an event.
 
    For more detail about banks for PMT hits see PIF.

    This is a "long skinny" bank, it's better to use the PMT bank.  
    See the  FAQ: What is the difference between the Px banks and the PMT?
 
Reference Links
---------------
 
    None.
 
Structural Links
----------------
 
    None.
 
Status Bits
-----------
 
Note: Any status bit parameters are defined to work with bit functions such as
      IAND and BTEST.
 
  0  KPIX_DIGITIZED    Data stored in digitized form.
  1  KPIX_MISSING_PMT  Bank contains missing PMTS i.e. no CCC. See Note 2 

Data Words
----------
 
    Data types: B(bit), I, F, D(double), H(hollerith 4 char)
 
 
 +i  I        Depending on the setting of KPIX_DIGITIZED See Note 1 :-
                 =0   Tube number 
                 =1   CCC DAQ Circuit Number
                          = 1024*card + 32*crate + channel
                      (or - tube number see Note 2)

Notes
-----
 
 
1)  All real data comes in digitized form and so the PIN bank holds CCC numbers.
    For Monte Carlo data however, the PIN bank initially holds PMT tube numbers
    which are subsequently converted to CCC in UCL:  Event UnCalibration


2)  Before development release 3.0081, SNOMAN code used all 9552 PMTs and just
    recorded the tube number in this bank.  After that, missing PMTs were 
    excluded and the PIN held CCC after uncalibration.  If reading old data
    the PIN bank is converted but a problem arises if it contains missing
    PMTs for these have no corresponding CCCs. In this case:-

    o  The KPIX_MISSING_PMT is set.
    o  Any slot that corresponds to a missing tube holds the negated tube no. 
       instead of CCC.
    
    This allows CAL:  Event Calibration to map PIN -> PN correctly even if the
    tube is missing.