Titles: MCDQ ============= Contact: D. Wark, Oxford. Revision History:- ================ 2.06 N. West First version with revision history. Correct comments on T_LATE and T_EARLY. 2.07 D. Wark Add ZTELL_ENABLE. 2.08 J. Klein Re-write for new trigger simulation. 3.01 D. Wark Add external trigger words. D. Wark Add source trigger words. 3.02 J. Klein Add dropout and drift words. 4.01 A. Hamian Add flag to enable/disable inclusion of dqxx info in MC 5.00 N. West Add ENABLE_NCD_TRIGGER. H. Deng Add ncd triggger switch J. Klein Major restructuring with more triggers. 5.01 J. Klein Add switches/flags for new charge spectrum. C. Kyba Fix typo: CHTRESH should be CTHRESH J. Klein Extend Charge spectrum and channel efficiency simulation mode M. Dunford Add comments making one of the chan. eff. obsolete Titles Files ------------ mc_daq.dat Verification ------------ Description ----------- This bank contains input data for the routine MCDAQ. Most of the words in this bank are actually fixed in hardware for the real data. Only words 2, 6, 7, 26 and 27 are "software" variables, the rest are fixed in the electronics. Data Words ---------- Fixed length Database Header. See titles_dbhdr.html Line Type Variable [symbolic command] Description ---- ---- -------- ------------------------------- 1 F OBSOLETE (pre 4.0287) This is the hardware threshold, do not create a trigger which hit fewer than HTHRESH different PMT's within T_TRIGGER. 2 I CTHRESH This is an absolute cutoff, if the number of hit PMT's is less than this the event is binned. CAUTION: The decision is made before noise is added, so do not set this number to the actual threshold you want or you will lose events near threshold. 3 I ZTELL_ENABLE Set = 1 to enable calls to ZTELL, anything else disables. 4 F OBSOLETE (pre 4.0287) The width of the trigger pulse in ns. 5 F T_RISE The rise time of the trigger pulse in ns. 6 F T_AMP_JITT Fractional amplitude jitter in trigger pulse. 7 F T_DISC Hits this many ns before the arrival of the trigger are saved. 8 F T_SUM_DELAY Delay of trigger pulse from FEC to central trigger card. 9 F T_FEC_DELAY Delay of global trigger signal from central triggercard to FEC. 10 F T_LOCKOUT Global trigger lockout time. 11 F T_LATE Time after last hit in group to add noise. 12 F T_EARLY Time before first hit in group to add noise. 13 F T_SHORT Length of the short integration time. 14 F T_LONG Length of the long integration time. 15 F T_WAIT Length of time PMT discriminator is disabled after hit. 16 F GAIN_LOW Amount by which PMT gain is reduced for the high-amplitude channel. 17 F T_LG Length of time the high-amplitude channel integrates over. 18 I CURL_FLAG Flag to turn TAC curl on (1) or off (0). 19 F T_CURL TAC curl moves events this long after the beginning of the window. 20 F CURL_SLOPE Controls how far forward a hit gets moved by the TAC curl. A hit that occurs at time T < T_CURL after the opening of the window will get recorded at time T_CURL + CURL_SLOPE*(T_CURL - T) 21 I EXT_FLAG Forces external trigger at time EXT_TIME, 0 for no external trigger, -1 for asynch., 1 for synch. 22 F EXT_TIME Time of forced external trigger. 23 I EXT_SOURCE The number of the source generating the trigger (1=generic source, 2=laser source, 3=16N source) (=0 just uses EXT_TIME) 24 F AVE_DROPOUT Average number of dropout channels. 25 F RMS_DRIFT RMS of trigger baseline drift (in NHIT). 26 I T_SIM_MODE [trigger_mode] Trigger simulation mode: 0=perfect trigger (ignores risetime, amplitude jitter, and disabled trigger pulses) 1=simulated trigger (includes risetime, amplitude jitter, dropout and drift) 2=simulated trigger (includes risetime, amplitude jitter,dropout, drift, and disabled trigger pulses) 3=measured trigger efficiency (perfect pulses + measured turn-on curve + correction for disabled channels) 4=measured+simulated (simulated pulses + measured turn-on curve---only recommended for systematic timing tests) 27 I USE_DQXX_FLAG Flag to decide whether or not to use DQXX info to discard hits in channels which were not online at generation time. (0 = do not use DQXX info, 1 = use DQXX info) 28 I ENABLE_NCD_TRIGGER {enable_ncd_trigger} 0 = disabled, 1= enabled. 29 I ENABLE_TRIGGERS Enabled triggers (which triggers will be simulated). This has the same form as the trigger mask, however if any of the N100 bits are selected, then all N100 triggers will be simulated. The same goes for N20 and ESUM. The EXT and NCD triggers are controlled by different flags, see above. 30 I MCTRIGMASK Trigger mask (3150 = standard SNO neutrino run) 31 I PRESCALE PRESCALE factor 32 I SPE_SIM_FLAG Charge spectrum and channel efficiency simulation mode: 0 = old charge spectrum and old (forced hit) efficiency 1 = new charge spectrum and old (forced hit) efficiency 2 = (THIS MODE IS OBSOLETE) new charge spect and new simulated hit efficiency, with renormalization of PMT collection efficiency 3 = new charge spect and new simulated hit efficiency, without renormalization of PMT collection efficiency 33 I SPE_GAIN_MODE PMT gain simulation mode for charge spectrum: 0 = PMT charge spectra all use the same gain (See SPEL bank in mc_generator.dat) 1 = PMT charge spectra use simulated distribution of PMT gains (high-half points) 2 = PMT charge spectra use real PMT gains from PCA calibration 34 I SPE_THR_MODE PMT channel threshold simulation mode: 0 = Use uniform fixed chan. thresholds (set in SPEL bank) 1 = Use simulated channel threshold distribution 2 = Use true channel thresholds from DQXX bank. 35.. I Spare integers. 46 F N100LO threshold in NHIT 47 F HTHRESH N100MED threshold in NHIT 48 F N100HI threshold in NHIT 49 F N20 threshold in NHIT 50 F N20LB threshold in NHIT 51 F ESUMHI threshold in mV 52 F ESUMLO threshold in mV 53 F TWORD_LATCH Latching time for trigger word in ns 54 F PGT_PERIOD PULSE_GT period in ms (note time units!) 55 F ESUM_DELAY Delay of ESUM signals relative to NHIT, in ns 56 F T_TRIGGER This is the width of the `100 ns' trigger pulse in ns. 57 F T20_TRIGGER This is the width of the `20 ns' trigger pulse in ns. 58... Spare floating point numbers