Overview¶
The following is a table containing details of all the RQs that are calculated in CDMSBats. All files mentioned in the "Calculated in what file" column are available in Batcommon/analysis folder. The sections are as follows:
Event Information (eventTree)¶
These RQ's are not calculated in a file but rather are read from the inputted raw data file. And so, there is no "Calculated in what file" column.
| RQ name | RQ Description |
|---|---|
| EventCategory | The following categories are most likely to be encountered: 0 = per trigger, 1 = occasional(random), 6 = per trigger w/ selective readout. See raw data specs for more |
| EventNumber | Number of event within its file series. The smallest 4 digits indicate the event number (0000 - 9999) within the file (max 500 at Soudan, 250 at test facilities); the larger digits indicate 10000x the file number within the series. The first event is thus numbered "10001". |
| EventTime | Time in seconds since 0:00 1 Jan 1970 GMT (resolution of 1 second) |
| EventType | Indicates the mode in which the data set was acquired: 0=WIMP Search, 1=60Co, 3=Neutron, 5=Pulser, 6=Test, 9=Ba (see raw data specs) |
| LiveTime | Time (in msec) that software was live, waiting for this event |
| NumTriggers | Total number of L1 triggers within event. (Same as TriggerNums) |
| PollingEndTime | The L2Trigger only considers triggers up to a certain timestamp on each iteration. This is that time (based on the DCRC clock). By definition, the next "real" event will have a trigger time after this time. |
| ReadoutType | BITMASK of which detectors were read out. 1: All detectors, 2: All detectors in same tower as triggering detector(s), 4: All detectors in same plane as triggering detector(s), 8: Just the triggering detector(s) |
| SeriesNumber | Number indicating date and time of file series start in the form pymmddhhmm (p=0,1,2,3 for SUF, Soudan, UCB, CWRU respectively), y is the last digit of the year, and the rest of the date proceeds as usual. For example, "1607231131" refers to a Soudan data series beginning at 11:31 a.m. local time on July 23, 2006. |
Trigger Information¶
| RQ name | RQ Description |
|---|---|
| TriggerAmplitude | Amplitude of primary pulse on primary detector for triggered event, in ADC bins. See TriggerDetectorNum for primary detector. |
| TriggerCoincidenceNums | Number of coincident L1 triggers. |
| TriggerDetectorNum | Detector number for primary trigger. |
| TriggerMask | Logic bits from the L1Trigger. |
| TriggerNums | Total number of L1 triggers within event. |
| TriggerPileUpNums | Number of pileup L1 triggers. |
| TriggerStatus | 1 if this is the main primitive trigger, which is the one that was used to determine which samples to read out. |
| TriggerTime | High-resolution time of trigger. Time resets to 0 every 2^32/fs seconds. |
| TriggerType | Cause of trigger: 1=physics, 2-5=randoms, 6-7=test signals, 8=polling cycle. |
| TriggerUnixTime | L1 trigger time in seconds since 0:00 1 Jan 1970 GMT |
| TriggerWord | From the L1Trigger, indicates what source triggered the event (see DCRC register map). |
| TriggerXXCoincidenceN | For XX paramter, gives the value for the N'th coincident trigger. |
| TriggerXXPileupN | For XX paramter, gives the value for the N'th pileup trigger. |
Simulation specific Event RQs¶
| RQ name | RQ Description |
|---|---|
| SIMAvgX/Y/Z | |
| SIMRecoilEnergy | |
| SIMSeriesNumber |
Detector General RQs¶
Phonon channel RQs have format: P*xxxx, where * = A-F for individual channels, S1/S2 for sum of one side, and T for sum of all channels on that detector. Charge channel * = I, O
| RQ name | RQ Description |
|---|---|
| Empty | Specifies whether the detector was read out or not for this event. Note that during low background data, this RQ should always be 0. Ba and sometimes Cf are taken in selective readout. In those cases, this value will be equal to -999999 when the detector failed to go over its plo threshold. |
| P*status DEPRECATED? | 0 -> OK (default if no informations below). 1 -> High resistance short (works ok). 2 -> Low resistance short (bad sensor) |
| Q*status DEPRECATED? | 0 -> OK (default if no informations below. 1 -> Shorted bias (FETs not disabled) Q*status. 2 -> Shorted feedback (FETs not disabled). 3 -> Shorted bias (FETs disabled). 4 -> Shorted feedback (FETs disabled). 5 -> Excessive odd noise |
| LEDstatus | 0 -> OK (default if no information below). 1 -> DIB1 LED1 OFF (for any reason). 2 -> DIB1 LED2 OFF (for any reason). 3 -> DIB2 LED1 OFF (for any reason). 4 -> DIB2 LED2 OFF (for any reason). Chain together numbers to get combinations i.e., 1234 -> ALL LED OFF |
Phonon RQs¶
* = channel name
| RQ Name | RQ Description | Calculated in what file | Algorithm description |
|---|---|---|---|
| P*OFamps | Amplitude of the phonon pulse | OptimalFilterPhonon.cxx | 1-D Optimal Filter |
| P*OFdelay | Optimal Filter delay in seconds from the global trigger | OptimalFilterPhonon.cxx | 1-D Optimal Filter |
| P*OFchisq | Optimal Filter chisquare | OptimalFilterPhonon.cxx | 1-D Optimal Filter |
| P*OFamps0 | Amplitude of the phonon pulse assuming the event occured simultaneously with the trigger. Useful for noise characterization. | OptimalFilterPhonon.cxx | 1-D Optimal Filter |
| P*OFchisqLF | Optimal Filter chisquare restricted to frequencies < 10kHz | OptimalFilterPhonon.cxx | 1-D Optimal Filter |
| P*INTall | Integral of whole low pass-filtered pulse | PulseIntegral.cxx | Pulse Integral |
| P*INTtrunc | Integral of low pass-filtered pulse over specified range as specified in UserSettings | PulseIntegral.cxx | Pulse Integral |
| P*Eabs | P*INTtrunc normalized to sample rate in eV | PulseIntegral.cxx | Pulse Integral |
| P*bs | Pre-trigger baseline mean (in adc digitizer bins) | BasicPulseCalc.cxx | -- |
| P*bspost | Mean last 100 bins (in adc digitizer bins) | BasicPulseCalc.cxx | -- |
| P*std | Standard Deviation | BasicPulseCalc.cxx | -- |
| P*sat | Number of bins in pulse above saturation value OR at the minimum digitizer value | BasicPulseCalc.cxx | -- |
| P*bias | Phonon QET bias in A | BasicPulseCalc.cxx, passed from cdmsbats and read from detector settings | -- |
| P*gain | Phonon total gain | BasicPulseCalc.cxx, passed from cdmsbats and read from detector settings | -- |
| P*norm | Phonon normalization (amps) | BasicPulseCalc.cxx, passed from cdmsbats and read from detector settings | -- |
| P*i0 | Baseline current in A | BasicPulseCalc.cxx, passed from cdmsbats and read from config files | -- |
| P*vb | Bias voltage in V | BasicPulseCalc.cxx, passed from cdmsbats and read from config files | -- |
| P*max | Maximum height of low pass filtered pulse in A | BasicPulseCalc.cxx | -- |
| P*maxpower | Maximum height of low pass filtered pulse in picoW | BasicPulseCalc.cxx | -- |
| P*PSDintall | Integral of pulse PSD over full frequency range | PSDIntegralPhonon.cxx | PSD Integral |
| P*PSDint0to1 | Integral of pulse PSD over indicated frequency range (in kHz) | PSDIntegralPhonon.cxx | PSD Integral |
| P*PSDint1to10 | Integral of pulse PSD over indicated frequency range (in kHz) | PSDIntegralPhonon.cxx | PSD Integral |
| P*WKr# | # = (every 10%) 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 % rise time from (post 50 kHz cutoff butterworth filter), in seconds relative to the start of digitization | ConstFreqRTFTWalkPhonon.cxx | RTFT Walk routines |
| P*WKf# | # = 20, 40, 80, 90, 95 % fall time (post 50 kHZ butterworth filter), in seconds relative to the start of digitization | ConstFreqRTFTWalkPhonon.cxx | RTFT Walk routines |
| P*WKmax | maximum of filtered pulse | ConstFreqRTFTWalkPhonon.cxx | RTFT Walk routines |
| P*TFPchisq | Tail fit chisquare (normalized by Ndof) | SingleExponentialFit.cxx | Minuit fit to pulse using functional form |
| P*TFPFamp | Tail fit Amplitude | SingleExponentialFit.cxx | Minuit fit to pulse using functional form |
| P*TFPoffset | Tail fit Offset | SingleExponentialFit.cxx | Minuit fit to pulse using functional form |
| P*TFPtau | Tail fit fall time (in seconds) | SingleExponentialFit.cxx | Minuit fit to pulse using functional form |
| P*TFPint | Tail fit intergral (= PTNFamp/PTNFtau) | SingleExponentialFit.cxx | Minuit fit to pulse using functional form |
| P*TFPeflag | Minuit fit flag (=0 if good fit) | SingleExponentialFit.cxx | Minuit fit to pulse using functional form |
Non-stationary OF¶
| RQ Name | RQ Description | Calculated in what file | Algorithm Description |
|---|---|---|---|
| PTNFchisq | Non Stationary Optimal Filter chisquare | OptimalFilterPhononNS.cxx | Non-stationary OF |
| PTNFdelay | Non Stationary Optimal Filter delay in seconds from the global trigger (constraint to PTOFdelay in Prodv5-3) | OptimalFilterPhononNS.cxx | Non-stationary OF |
| PTNFamps | Amplitude of the phonon pulse | OptimalFilterPhononNS.cxx | Non-stationary OF |
| PTNFamps0 | Amplitude, analagous to the P*OFamps0 | OptimalFilterPhononNS.cxx | Non-stationary OF |
Two-Template Optimal Filter¶
| RQ Name | RQ Description | Calculated in what file | Algorithm Description |
|---|---|---|---|
| P*OF1X2Pamps | Two-Template Optimal Filter Slow Amplitude | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2Pamps0 | Zero delay Two-Template Optimal Filter Slow Amplitude | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2Ramps | Two-Template Optimal Filter Fast Amplitude | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2Ramps0 | Zero delay Two-Template Optimal Filter Fast Amplitude | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2chisq | Two-Template Optimal Filter chisquare | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2delay | Two-Template Optimal Filter delay in seconds from the global trigger | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2DPamps | Binned Delay Two-Template Optimal Filter Slow Amplitude | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2DRamps | Binned Delay Two-Template Optimal Filter Fast Amplitude | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2Dchisq | Binned Delay Two-Template Optimal Filter chisquare | OptimalFilterPhonon1X2.cxx | Two Template OF |
| P*OF1X2Ddelay | Binned Delay Two-Template Optimal Filter delay in seconds from the global trigger | OptimalFilterPhonon1X2.cxx | Two Template OF |
Other RQs that are Outdated or Deprecated:¶
| RQ Name | RQ Description | Calculated in what file |
|---|---|---|
| P*PF <par-name > | Equivalent of the 5 parameter Time Domain fit from the PipeFitter code. Fits include amps, rise times, fall times, chisq, errors, etc | PipeFitPhonon.cxx |
| P*WF <par-name > | 3-parameter fit on phonon pulses (below 20% rising edge amplitude) using a polynomial functional form | WedgeFitPhonon.cxx |
| P*VWK <par-name > | Variable Frequency RTFT(RiseTimeFallTime)Walk algrorithm for phonon pulses | VarFreqRTFTWalkPhonon.cxx |
Charge RQs¶
| RQ Name | RQ Description | Calculated in what file | Algorithm Description |
|---|---|---|---|
| Q*OFnoXchisq | Optimal Filter chisquare without cross talk | OptimalFilterCharge.cxx | 1-D Optimal Filter |
| Q*OFnoXdelay | Optimal Filter delay (seconds relative to the global trigger) without cross talk | OptimalFilterCharge.cxx | 1-D Optimal Filter |
| Q*OFnoXvolts | Energy of the charge pulse volts, without cross talk | OptimalFilterCharge.cxx | 1-D Optimal Filter |
| Q*OFnoXvolts0 | Energy of the charge pulse volts assuming delay = 0 without cross talk. Useful for noise characterization | OptimalFilterCharge.cxx | 1-D Optimal Filter |
| Q*OFchisq | Optimal Filter chisquare | OptimalFilterChargeX.cxx | Cross-talk OF |
| Q*OFdelay | Optimal Filter delay | OptimalFilterChargeX.cxx | Cross-talk OF |
| Q*OFvolts | Energy of the charge pulse volts, amplitude is interpolated | OptimalFilterChargeX.cxx | Cross-talk OF |
| Q*OFvolts0 | Energy of the phonon pulse volts assuming delay = 0. Useful for noise characterization. | OptimalFilterChargeX.cxx | Cross-talk OF |
| Q*OFdiscreteChisq | Non-interpolated Optimal Filter chisquare | OptimalFilterChargeX.cxx | Cross-talk OF |
| QOFdiscreteDelay | Non-interpolated Optimal Filter delay | OptimalFilterChargeX.cxx | Cross-talk OF |
| Q*OFisMinChisq | OF fit type. Whether to do full chisq minimization or not | OptimalFilterChargeX.cxx | Cross-talk OF |
| Q*bs | Pre-trigger baseline mean, in adc digitizer bins | BasicPulseCalc.cxx | -- |
| Q*bspost | Last 100 bins baseline mean, in adc digitizer bins | BasicPulseCalc.cxx | -- |
| Q*std | Standard Deviation | BasicPulseCalc.cxx | -- |
| Q*sat | Number of bins in pulse above saturation value (or at minimum adc value) | BasicPulseCalc.cxx | -- |
| Q*bias | Charge bias | BasicPulseCalc.cxx, passed from cdmsbats and read from detector settings | -- |
| Q*gain | Charge total gain | BasicPulseCalc.cxx, passed from cdmsbats and read from detector settings | -- |
| Q*norm | Charge normalization (volts), same as Q*gain | BasicPulseCalc.cxx, passed from cdmsbats and read from config files | -- |
| Q*max | Maximum height of low pass filtered pulse | BasicPulseCalc.cxx | -- |
| Q*i0 | Baseline current | BasicPulseCalc.cxx, passed from cdmsbats and read from config files | -- |
| Q*vb | Bias voltage | BasicPulseCalc.cxx, passed from cdmsbats and read from config files | -- |
| Q*maxpower | Maximum height of low pass filtered pulse in picoW | BasicPulseCalc.cxx | -- |
| Q*F5base | Baseline from F5 fit | F5ChargeX.cxx | F5 Fit |
| Q*F5chisq | Chisq from F5 fit | F5ChargeX.cxx | F5 Fit |
| Q*F5volts | Amplitude from F5 fit | F5ChargeX.cxx | F5 Fit |
| QF5satdelay | Delay for both QI and QO | F5ChargeX.cxx | F5 Fit |
| Q*r<% no> | % risetime from rtftwalk (post butterworth filter), in seconds from the start of digitization | RTFTWalkCharge.cxx | RTFT Walk routines |
| Q*max | Maximum height of un-normalized pulse (post butterworth filter) - in volts | RTFTWalkCharge.cxx | RTFT Walk routines |
2x2 charge Optimal Filter¶
| RQ Name | RQ Description | Calculated in what file | Algorithm description |
|---|---|---|---|
| Q*OFchisq | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
| Q*OFdelay | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
| Q*OFvolts | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
| Q*OFvolts0 | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
| Q*OFdiscreteChisq | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
| Q*OFdiscreteDelay | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
| Q*OFdiscreteChisqVolts | No Description yet | OptimalFilterCharge2X2.cxx | NxM Optimal Filter |
Other RQs (possibly deprecated)¶
ch= channel name
| RQ Name | RQ Description | Calculated in what file |
|---|---|---|
| <ch >imaxt | Max inflection | InflectionTime.cxx |
| <ch >imint | Max inflection time in bins? | InflectionTime.cxx |
| <ch >imax | Min inflection | InflectionTime.cxx |
| <ch >imin | Min inflection time in bins? | InflectionTime.cxx |
| VT <par-name> | Veto pulse analysis algorithm imported from the PipeFitter code. | VetoAnalysis.cxx |