BADC: Bad ADC's (from CALDAC)

                              Titles:  BADC
                              =============
 
Contact:  Richard Van de Water
 
 
Revision History:-
================
 
4.02    Richard Van de Water  First version. 


 
Titles Files
------------
 
None so far. 
 
Verification
------------
 
 
Description
-----------

he BADC bank contains the CALDAC information (bad ADC's).  These are
nonlinear ADC's that were identified by the CALDAC test (electronics
diagnostic hardware/code using an onboard DAC on the motherboard).
The run was done once a month up to Aug 8/00, when the ADC's were
permanently fixed with a modification.
 
 
Data Words
----------
 
        Fixed length Database Header.  See titles_dbhdr.html

    Data types: B(bit), I, F, D(double), H(hollerith 4 char)

Word    Type     Description

 1       I       crate 0, slot 0, Qhl ADC flag (ok= 0, bad > 0)
 2       I       crate 0, slot 0, TAC ADC flag (ok= 0, bad > 0)
 3       I       crate 0, slot 0, Qlx ADC flag (ok= 0, bad > 0)
 4       I       crate 0, slot 0, Qhs ADC flag (ok= 0, bad > 0)

 5       I       crate 0, slot 1, Qhl ADC flag (ok= 0, bad > 0)
 6       I       crate 0, slot 1, TAC ADC flag (ok= 0, bad > 0)
 7       I       crate 0, slot 1, Qlx ADC flag (ok= 0, bad > 0)
 8       I       crate 0, slot 1, Qhs ADC flag (ok= 0, bad > 0)

 .
 .
 .
word = 64 * icr + 4*ica + i    I   crate icr= 0 to 18, slot ica= 0 to 15,
                                   i=1 (Qhl), 2 (TAC), 3 (Qlx), 4 (Qhs)


Program Notes
-------------

Nonlinear ADC's plagued the detector for the first year of running
(till August of 2000) before they were permanently fixed with the LED
modification.  This systematic is handled in the analysis by having
the capability to turn off (or flag) bad slots that had misbehaving
ADC's identified via either the CALDAC test, or Frati's jump method.
See the ECA document (SNO-STR-2001-005) for full details.

The data from the CALDAC tests (done once a month) are hand scanned,
and the bad ADC's are identified and flagged by setting a bit for the
appropriate crate/slot/ADC in the BADC titles.  The validity of the
bank is backwards, since when the test was done, the ADC's were
susbsequently fixed by heating.  There is one bit for each of Qhs,
Qhl, Qlx, and TAC.  If the ADC is flagged, then all 32 channels
associated with the Q/TAC for the Motherboard in question are flagged
as bad.  The BADC titles are in SNODB.

During application of the ECA constants, the user can choose how to
handle bad ADC's with word 16 in the TCAL bank.  A decription of the
options follows:

A) Set bank TCAL 1 word 15 to 0: Set the bits 9-14 of the ECA status
word in the hit PMT bank (KPMT_ECA_VAL) according to information in
the relevant BADC titles.

B) Set bank TCAL 1 word 15 to 1: Same as 0, plus, if Q/TAC ADC is
flagged as bad from CALDAC test (BADC titles), set associated Q/TAC
-9999. This affects all 32 common channels on a Motherboard (slot).

C) Set bank TCAL 1 word 15 to 2:  Same as 0, plus, if Frati jump
test failed for channel/slot, set associated Q/TAC to -9999.