Straxen nT datastructure for muon veto
This page is an autogenerated reference for all the plugins in straxen’s xenonnt_online context.
Colors indicate data kinds. To load tables with different data kinds, you currently need more than one get_df (or get_array) commands.
veto_regions_mv
Description
Provided by plugin: muVETOVetoRegions
Data kind: veto_regions_mv
Muno-Veto Plugin: Same as the corresponding nVETO-Plugin.
Plugin which defines the time intervals in which peaks should be tagged as vetoed. An event must surpass all three criteria to trigger a veto.
Columns provided
| Field name | Data type | Comment |
|---|---|---|
| time | int64 | Start time since unix epoch [ns] |
| endtime | int64 | Exclusive end time since unix epoch [ns] |
Dependencies
Configuration options
These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.
| option | default | current | help |
|---|---|---|---|
| min_veto_area_mv | 10 | <OMITTED> | Minimal area required in pe to trigger veto. |
| min_veto_area_nv | 5 | <OMITTED> | Minimal area required in pe to trigger veto. |
| min_veto_channel_mv | 5 | <OMITTED> | Minimal number PMT channel contributing to the event. |
| min_veto_channel_nv | 0 | <OMITTED> | Minimal number PMT channel contributing to the n/mveto_event. |
| min_veto_hits_mv | 0 | <OMITTED> | Minimal number of hitlets in event to trigger veto. |
| min_veto_hits_nv | 10 | <OMITTED> | Minimal number of hitlets in n/mveto_event to trigger a veto. |
| veto_left_extension_mv | 0 | <OMITTED> | Veto time in ns left t the start of a vetoing event. |
| veto_left_extension_nv | 500000 | <OMITTED> | Veto time in ns left t the start of a vetoing event. |
| veto_right_extension_mv | 1000000 | <OMITTED> | Veto time in ns right to the end of a vetoing event. |
| veto_right_extension_nv | 0 | <OMITTED> | Veto time in ns right to the end of a vetoing event. |
records_mv
Description
Provided by plugin: muVETOPulseProcessing
Data kind: records_mv
Muno-Veto Plugin: Same as the corresponding nVETO-PLugin.
nVETO equivalent of pulse processing. The following steps are applied:
Flip, baseline and integrate waveforms.
Find hits and apply ZLE
Remove empty fragments.
Columns provided
| Field name | Data type | Comment |
|---|---|---|
| time | int64 | Start time since unix epoch [ns] |
| length | int32 | Length of the interval in samples |
| dt | int16 | Width of one sample [ns] |
| channel | int16 | Channel/PMT number |
| pulse_length | int32 | Length of pulse to which the record belongs (without zero-padding) |
| record_i | int16 | Fragment number in the pulse |
| area | int32 | Integral in ADC counts x samples |
| reduction_level | uint8 | Level of data reduction applied (strax.ReductionLevel enum) |
| baseline | float32 | Baseline in ADC counts. data = int(baseline) - data_orig |
| baseline_rms | float32 | Baseline RMS in ADC counts. data = baseline - data_orig |
| amplitude_bit_shift | int16 | Multiply data by 2**(this number). Baseline is unaffected. |
| data | ('<i2', (110,)) | Waveform data in raw counts above integer part of baseline |
Dependencies
Configuration options
These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.
| option | default | current | help |
|---|---|---|---|
| baseline_samples_mv | 100 | <OMITTED> | Number of samples to use at the start of the pulse to determine the baseline |
| baseline_samples_nv | (baseline_samples_nv, ONLINE, True) | <OMITTED> | Number of samples to use at the start of the pulse to determine the baseline |
| channel_map | <OMITTED> | (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) | immutabledict mapping subdetector to (min, max) channel number. |
| check_raw_record_overlaps | True | <OMITTED> | Crash if any of the pulses in raw_records overlap with others in the same channel |
| daq_chunk_duration | 5000000000 | <OMITTED> | Duration of regular chunks in ns |
| daq_compressor | lz4 | <OMITTED> | Algorithm used for (de)compressing the live data |
| daq_input_dir | <OMITTED> | <OMITTED> | Directory where readers put data |
| daq_overlap_chunk_duration | 500000000 | <OMITTED> | Duration of intermediate/overlap chunks in ns |
| erase | False | <OMITTED> | Delete reader data after processing |
| hit_min_amplitude_mv | (hit_thresholds_mv, ONLINE, True) | <OMITTED> | Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_mveto_pmts, or a number, or a string like "pmt_commissioning_initial" which means calling hitfinder_thresholds.py, or a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt. |
| hit_min_amplitude_nv | (hit_thresholds_nv, ONLINE, True) | <OMITTED> | Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_nveto_pmts, or a number, or a string like "pmt_commissioning_initial" which means calling hitfinder_thresholds.py, or a tuple like (correction=str, version=str, nT=boolean), which means we are using cmt. |
| max_digitizer_sampling_time | 10 | <OMITTED> | Highest interval time of the digitizer sampling times(s) used. |
| min_samples_alt_baseline_nv | None | <OMITTED> | Min. length of pulse before alternative baselineing via pulse median is applied. |
| readout_threads | <OMITTED> | <OMITTED> | Dictionary of the readout threads where the keys specify the reader and value the number of threads |
| record_length | 110 | <OMITTED> | Number of samples per raw_record |
| run_start_time | 0 | <OMITTED> | time of start run (s since unix epoch) |
| safe_break_in_pulses | 1000 | <OMITTED> | Time (ns) between pulses indicating a safe break in the datastream -- gaps of this size cannot be interior to peaklets. |
| save_outside_hits_mv | (2, 5) | <OMITTED> | Save (left, right) samples besides hits; cut the rest |
| save_outside_hits_nv | (3, 15) | <OMITTED> | Save (left, right) samples besides hits; cut the rest |
hitlets_mv
Description
Provided by plugin: muVETOHitlets
Data kind: hitlets_mv
Muno-Veto Plugin: Same as the corresponding nVETO-PLugin.
Plugin which computes the nveto hitlets and their parameters.
Hitlets are an extension of regular hits. They include the left and right extension. The plugin does the following:
- Generate hitlets which includes these sub-steps:
Apply left and right hit extension and concatenate
overlapping hits. * Generate temp. hitelts and look for their waveforms in their corresponding records. * Split hitlets if they satisfy the set criteria.
Compute the properties of the hitlets.
- Note:
Hitlets are getting chopped if extended in not recorded regions.
Columns provided
| Field name | Data type | Comment |
|---|---|---|
| time | int64 | Start time since unix epoch [ns] |
| length | int32 | Length of the interval in samples |
| dt | int16 | Width of one sample [ns] |
| channel | int16 | Channel/PMT number |
| area | float32 | Total hit area in pe |
| amplitude | float32 | Maximum of the PMT pulse in pe/sample |
| time_amplitude | int16 | Position of the Amplitude in ns (minus "time") |
| entropy | float32 | Hit entropy |
| range_50p_area | float32 | Width (in ns) of the central 50% area of the hitlet |
| range_80p_area | float32 | Width (in ns) of the central 80% area of the hitlet |
| left_area | float32 | Position of the 25% area decile [ns] |
| low_left_area | float32 | Position of the 10% area decile [ns] |
| range_hdr_50p_area | float32 | Width (in ns) of the highest density region covering a 50% area of the hitlet |
| range_hdr_80p_area | float32 | Width (in ns) of the highest density region covering a 80% area of the hitlet |
| left_hdr | float32 | Left edge of the 50% highest density region [ns] |
| low_left_hdr | float32 | Left edge of the 80% highest density region [ns] |
| fwhm | float32 | FWHM of the PMT pulse [ns] |
| left | float32 | Left edge of the FWHM [ns] (minus "time") |
| fwtm | float32 | FWTM of the PMT pulse [ns] |
| low_left | float32 | Left edge of the FWTM [ns] (minus "time") |
Dependencies
Configuration options
These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.
| option | default | current | help |
|---|---|---|---|
| channel_map | <OMITTED> | (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) | immutabledict mapping subdetector to (min, max) channel number. |
| entropy_square_data_mv | False | <OMITTED> | Parameter which decides if data is first squared before normalized and compared to the template. |
| entropy_square_data_nv | False | <OMITTED> | Parameter which decides if data is first squared before normalized and compared to the template. |
| entropy_template_mv | flat | <OMITTED> | Template data is compared with in conditional entropy. Can be either "flat" or a template array. |
| entropy_template_nv | flat | <OMITTED> | Template data is compared with in conditional entropy. Can be either "flat" or an template array. |
| gain_model_mv | (to_pe_model_mv, ONLINE, True) | (to_pe_model_mv, ONLINE, True) | PMT gain model. Specify as (model_type, model_config) |
| gain_model_nv | (to_pe_model_nv, ONLINE, True) | (to_pe_model_nv, ONLINE, True) | PMT gain model. Specify as (model_type, model_config, nT = True) |
| hit_min_amplitude_mv | (hit_thresholds_mv, ONLINE, True) | <OMITTED> | Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_mveto_pmts, or a number, or a string like "pmt_commissioning_initial" which means calling hitfinder_thresholds.py, or a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt. |
| hit_min_amplitude_nv | (hit_thresholds_nv, ONLINE, True) | <OMITTED> | Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_nveto_pmts, or a number, or a string like "pmt_commissioning_initial" which means calling hitfinder_thresholds.py, or a tuple like (correction=str, version=str, nT=boolean), which means we are using cmt. |
| min_split_mv | 100 | <OMITTED> | Minimum height difference pe/sample between local minimum and maximum, that a pulse get split. |
| min_split_nv | 0.063 | <OMITTED> | Minimum height difference pe/sample between local minimum and maximum, that a pulse get split. |
| min_split_ratio_mv | 0 | <OMITTED> | Min ratio between local maximum and minimum to split pulse (zero to switch this off). |
| min_split_ratio_nv | 0.75 | <OMITTED> | Min ratio between local maximum and minimum to split pulse (zero to switch this off). |
| save_outside_hits_mv | (2, 5) | <OMITTED> | Save (left, right) samples besides hits; cut the rest |
| save_outside_hits_nv | (3, 15) | <OMITTED> | Save (left, right) samples besides hits; cut the rest |
events_mv
Description
Provided by plugin: muVETOEvents
Data kind: events_mv
Plugin which computes the boundaries of veto events.
Columns provided
| Field name | Data type | Comment |
|---|---|---|
| time | int64 | Start time since unix epoch [ns] |
| endtime | int64 | Exclusive end time since unix epoch [ns] |
| event_number_mv | int64 | Veto event number in this dataset |
| area | float32 | Total area of all hitlets in event [pe] |
| n_hits | int32 | Total number of hitlets in events |
| n_contributing_pmt | uint8 | Total number of contributing channels |
| area_per_channel | ('<f4', (84,)) | Area in event per channel [pe] |
| center_time | float32 | Area weighted mean time of the event relative to the event start [ns] |
| center_time_spread | float32 | Weighted variance of time [ns] |
Dependencies
Configuration options
These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.
| option | default | current | help |
|---|---|---|---|
| channel_map | <OMITTED> | (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) | immutabledict mapping subdetector to (min, max) channel number. |
| event_left_extension_mv | 0 | <OMITTED> | Extends events this many ns to the left |
| event_left_extension_nv | 0 | <OMITTED> | Extends events this many ns to the left |
| event_min_hits_mv | 3 | <OMITTED> | Minimum number of fully confined hitlets to define an event. |
| event_min_hits_nv | 3 | <OMITTED> | Minimum number of fully confined hitlets to define an event. |
| event_resolving_time_mv | 300 | <OMITTED> | Resolving time for fixed window coincidence [ns]. |
| event_resolving_time_nv | 300 | <OMITTED> | Resolving time for fixed window coincidence [ns]. |
raw_records_aux_mv
Description
Provided by plugin: DAQReader
Data kind: raw_records_aux_mv
Read the XENONnT DAQ-live_data from redax and split it to the appropriate raw_record data-types based on the channel-map.
Does nothing whatsoever to the live_data; not even baselining.
- Provides:
raw_records: (tpc)raw_records.
raw_records_he: raw_records for the high energy boards
digitizing the top PMT-array at lower amplification. - raw_records_nv: neutron veto raw_records; only stored temporary as the software coincidence trigger not applied yet. - raw_records_mv: muon veto raw_records. - raw_records_aqmon: raw_records for the acquisition monitor (_nv for neutron veto).
Columns provided
| Field name | Data type | Comment |
|---|---|---|
| time | int64 | Start time since unix epoch [ns] |
| length | int32 | Length of the interval in samples |
| dt | int16 | Width of one sample [ns] |
| channel | int16 | Channel/PMT number |
| pulse_length | int32 | Length of pulse to which the record belongs (without zero-padding) |
| record_i | int16 | Fragment number in the pulse |
| baseline | int16 | Baseline determined by the digitizer (if this is supported) |
| data | ('<i2', (110,)) | Waveform data in raw ADC counts |
Dependencies
Configuration options
These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.
| option | default | current | help |
|---|---|---|---|
| channel_map | <OMITTED> | (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) | immutabledict mapping subdetector to (min, max) channel number. |
| daq_chunk_duration | 5000000000 | <OMITTED> | Duration of regular chunks in ns |
| daq_compressor | lz4 | <OMITTED> | Algorithm used for (de)compressing the live data |
| daq_input_dir | <OMITTED> | <OMITTED> | Directory where readers put data |
| daq_overlap_chunk_duration | 500000000 | <OMITTED> | Duration of intermediate/overlap chunks in ns |
| erase | False | <OMITTED> | Delete reader data after processing |
| max_digitizer_sampling_time | 10 | <OMITTED> | Highest interval time of the digitizer sampling times(s) used. |
| readout_threads | <OMITTED> | <OMITTED> | Dictionary of the readout threads where the keys specify the reader and value the number of threads |
| record_length | 110 | <OMITTED> | Number of samples per raw_record |
| run_start_time | 0 | <OMITTED> | time of start run (s since unix epoch) |
| safe_break_in_pulses | 1000 | <OMITTED> | Time (ns) between pulses indicating a safe break in the datastream -- gaps of this size cannot be interior to peaklets. |
raw_records_mv
Description
Provided by plugin: DAQReader
Data kind: raw_records_mv
Read the XENONnT DAQ-live_data from redax and split it to the appropriate raw_record data-types based on the channel-map.
Does nothing whatsoever to the live_data; not even baselining.
- Provides:
raw_records: (tpc)raw_records.
raw_records_he: raw_records for the high energy boards
digitizing the top PMT-array at lower amplification. - raw_records_nv: neutron veto raw_records; only stored temporary as the software coincidence trigger not applied yet. - raw_records_mv: muon veto raw_records. - raw_records_aqmon: raw_records for the acquisition monitor (_nv for neutron veto).
Columns provided
| Field name | Data type | Comment |
|---|---|---|
| time | int64 | Start time since unix epoch [ns] |
| length | int32 | Length of the interval in samples |
| dt | int16 | Width of one sample [ns] |
| channel | int16 | Channel/PMT number |
| pulse_length | int32 | Length of pulse to which the record belongs (without zero-padding) |
| record_i | int16 | Fragment number in the pulse |
| baseline | int16 | Baseline determined by the digitizer (if this is supported) |
| data | ('<i2', (110,)) | Waveform data in raw ADC counts |
Dependencies
Configuration options
These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.
| option | default | current | help |
|---|---|---|---|
| channel_map | <OMITTED> | (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) | immutabledict mapping subdetector to (min, max) channel number. |
| daq_chunk_duration | 5000000000 | <OMITTED> | Duration of regular chunks in ns |
| daq_compressor | lz4 | <OMITTED> | Algorithm used for (de)compressing the live data |
| daq_input_dir | <OMITTED> | <OMITTED> | Directory where readers put data |
| daq_overlap_chunk_duration | 500000000 | <OMITTED> | Duration of intermediate/overlap chunks in ns |
| erase | False | <OMITTED> | Delete reader data after processing |
| max_digitizer_sampling_time | 10 | <OMITTED> | Highest interval time of the digitizer sampling times(s) used. |
| readout_threads | <OMITTED> | <OMITTED> | Dictionary of the readout threads where the keys specify the reader and value the number of threads |
| record_length | 110 | <OMITTED> | Number of samples per raw_record |
| run_start_time | 0 | <OMITTED> | time of start run (s since unix epoch) |
| safe_break_in_pulses | 1000 | <OMITTED> | Time (ns) between pulses indicating a safe break in the datastream -- gaps of this size cannot be interior to peaklets. |