bank_rsp


           RSP     Energy Calibration Bank
           ===============================
 
    Contact:  M. Boulay, Queens.
 
    Revision History:-
    ================
 
    4.00  M. Boulay   First version.
    4.02  M. Boulay   Revised KTRSP_NWIN to include prompt hits
                      witout PCA correction, KTRSP_NWIN_PT now
                      includes prompt hits with PCA correction.
		      Added KTRSP_TSHIFT, average time shift between
		      walk-corrected and non-corrected times. 
    5.01 R.F. MacLellan Add alternate energy estimator.
    5.01 R.F. macLellan Add additional words for alt energy.

 
Description
-----------
 
    Holds results from the energy calibration processor.
 
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  KRSP_OK   This event has a valid energy calibration.
 
Data Words
----------
 
    Data types: B(bit), I, F, D(double), H(hollerith 4 char)
  
 +1  F KRSP_OPTICAL_RESPONSE Optical response for this event.
 +2  F KRSP_NWIN             Number of in-time hits.
 +3  F KRSP_NWIN2            Total number of in-time hits (MC only), 
                             see note 1.
 +4  F KRSP_NDARK            Average number of noise hits in window.
 +5  F KRSP_NEFF             Effective hits, see note 2.
 +6  F KRSP_NCOR             Corrected hits, see note 3.
 +7  F KRSP_NCORMC           Scaled corrected hits, see note 4.
 +8  F KRSP_NONLINE          Number of on-line tubes.
 +9  F KRSP_NCAL             Number of calibratable tubes, 
                             see note 5.
 +10  F KRSP_NEFFICIENT      Number of tubes with efficiency > 0, 
                             see note 5.
 +11  F KRSP_NWORKING        Number of working tubes, see note 5.
 +12  F KRSP_ENE             Estimated energy in MeV.
 +13  F KRSP_UNCERTAINTY     Uncertainty on above.
 +14  F KRSP_QUALITY         Quality of energy calibration.
 +15  F KRSP_R_D2O           D2O contribution to response.
 +16  F KRSP_R_ACR           Acrylic contribution to response.
 +17  F KRSP_R_H2O           H2O contribution to response.
 +18  F KRSP_R_FRESNEL       Fresnel scattering contribution to 
                             response, see note 6.
 +19  F KRSP_R_MPE           MPE contribution to response.
 +20  F KRSP_R_PMTR          PMT response contribution to response.
 +21  F KRSP_R_EFF           PMT efficiency contribution to response.
 +22  F KRSP_DRIFT           Scale drift correction  
 +23  F KRSP_NHITS           Total number of working inward-looking PMTs
                             which have fired in this event.
 +24  I KRSP_FIT_IDX         Index of vertex fitter used.
 +25  F KRSP_NWIN_ALLQ       Number of working inward looking tubes in the 
                             prompt time window which have fired, without the
			     software charge threshold. See note 3.
 +26  F KRSP_NHITS_ALLQ      Number of working inward looking tubes which have
                             fired without the software charge threshold.
			     See note 3.
 +27  F KRSP_NHITS_DQXX      Number of online inword looking tubes which have
                             fired.  See note 3.
 +28  F KRSP_NWIN_PT         In-time hits with walk-correction and charge cut.
 +29  F KRSP_TSHIFT          Time shift between walk corrected and non-corrected
                             times.
 +30  F KRSP_PMT_RESPONSE    RSP PMT response.
 +31  F KRSP_ALT_ENERGY      Alternate RSP energy see note 8.
 +32  F KRSP_NCKV            Alternate RSP Ncor equivalent.
 +33  F KRSP_RESOLUTION      RSP resolution estimate, not yet defined.
 +34  F KRSP_FOM             RSP figure of merit, not yet defined.
 +35  F KRSP_NCD_SHAD_COR    NCD shadow correction, not yet defined.
 +36  F KRSP_RLAMBDA         New energy optical response
 +37  F KRSP_OMEGA           New energy solid angle response
 +38  F KRSP_CKVPROB         New energy cerenkov distribution response
 +39  F KRSP_CHANEFF         New energy channel efficiency response
 +40  F KRSP_PMTEFF          New energy relative PMT efficiency response
 +41  F KRSP_MPE             New energy MPE response
 +42  F Spare.
 ..     ..
 +50  F Spare.

Notes
-----
 
 

0)  KRSP_NWIN holds the total number of in-time discriminator
    firings using non-walk corrected times and without a 
    software charge threshold.  KRSP_NWIN_PT uses walk-corrected
    times and applies the charge threshold.

1)  KRSP_NWIN2 holds the total number of in-time discriminator 
    firings for a Monte-Carlo event which can be used to study 
    multi-photon effects.

2)  KRSP_NEFF is defined as NWIN - NDARK.

3)  KRSP_NCOR is defined as KRSP_NEFF x (1./optical_response) x 
    (total no. tubes)/(no. tubes online).

4)  KRSP_NCORMC is a scaled version of KRSP_NCOR.  
    This should only be used for testing.

5)  KRSP_NEFFICIENT  is currently only a placeholder.  The total number
    of tubes online are counted by several methods:
    KRSP_NWORKING :   Number of working tubes, tubes which are determined
                      to be on-line from the DQXX info, the ECA validation,
		      and the RSPS validation.  This number of tubes
		      are counted towards RSP_NWIN, the primary energy
		      estimator.
    KRSP_NONLINE :    Number of tubes defined as 'online' with the DQXX info.
    KRSP_NCAL    :    Number of tubes which are 'online' and pass the RSPS
                      validation.
 
6)  With the current +/- 10 nsec time window, corrections for 
    Fresnel transmission through the acrylic interfaces are not 
    included in the optical response, since reflected/transmitted 
    light will both be in-time.

7)  The raw hit totals for a given event are defined as follows:
    a)  Number of hits in a prompt time window:
       KRSP_NWIN : number of tubes which have fired, are defined as
                   'working' above, and are in the prompt window,
		   without PCA walk correction or charge cut.
       KRSP_NWIN2: same as above but mulitple hits on the same channel are
                   counted (MC).
       KRSP_NWIN_PT: same as Nwin but using PCA walk-corrected times and 
                     applying a software charge threshold.
       KRSP_NWIN_ALLQ: same as KRSP_NWIN_PT but without the sofware treshold.
    b) No time window:
       KRSP_NHITS: same as KRSP_NWIN_PT but without a prompt time window applied.
       KRSP_NHITS_ALLQ: same as above but without a software charge threshold.
       KRSP_NHITS_DQXX: number of tubes which have fired and are defined
                        as 'online' in the DQXX info.

       The energy estimator used in RSP is KRSP_NWIN.

8  If calculating both RSP energy types this word is filled with the 
   alternate energy. Which energy this is depends upon TRSP word 23.



Go Back to the Snoman Companion Top Page