Straxen nT datastructure for neutron 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.

raw_records_nv

Description

Provided by plugin: DAQReader

Data kind: raw_records_nv

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

%3 raw_records_nv raw_records_nv raw_records_aqmon_nv raw_records_aqmon_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv (baseline_samples_nv, ONLINE, True) <OMITTED> Number of samples used in baseline rms calculation
channel_map <OMITTED> (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) frozendict mapping subdetector to (min, max) channel number.
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_nv True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
coincidence_level_recorder_nv 3 <OMITTED> Required coincidence level.
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_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.
n_lone_records_nv 2 <OMITTED> Number of lone hits to be stored per channel for diagnostic reasons.
pre_trigger_time_nv 150 <OMITTED> Pretrigger time before coincidence window in ns.
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
resolving_time_recorder_nv 600 <OMITTED> Resolving time of the coincidence in ns.
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_aqmon_nv

Description

Provided by plugin: DAQReader

Data kind: raw_records_aqmon_nv

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

%3 raw_records_nv raw_records_nv raw_records_aqmon_nv raw_records_aqmon_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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.

events_nv

Description

Provided by plugin: nVETOEvents

Data kind: events_nv

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_nv 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', (120,)) 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

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv 0 <OMITTED> Extends events this many ns to the left
event_min_hits_nv 3 <OMITTED> Minimum number of fully confined hitlets to define an event.
event_resolving_time_nv 300 <OMITTED> Resolving time for fixed window coincidence [ns].

veto_regions_nv

Description

Provided by plugin: nVETOVetoRegions

Data kind: veto_regions_nv

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

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv 5 <OMITTED> Minimal area required in pe to trigger veto.
min_veto_channel_nv 0 <OMITTED> Minimal number PMT channel contributing to the n/mveto_event.
min_veto_hits_nv 10 <OMITTED> Minimal number of hitlets in n/mveto_event to trigger a veto.
veto_left_extension_nv 500000 <OMITTED> Veto time in ns left t the start of a vetoing event.
veto_right_extension_nv 0 <OMITTED> Veto time in ns right to the end of a vetoing event.

raw_records_coin_nv

Description

Provided by plugin: nVETORecorder

Data kind: raw_records_coin_nv

Plugin which builds a software trigger based on records. The trigger is defined by a simple coincidence between pulse fragments within the specified resolving time. All records which do not fall into one of the coincidence windows are labeled as lone records for which we compute some average properties for monitoring purposes. Depending on the setting also a fixed number of the lone_records per channel are stored.

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

%3 raw_records_nv raw_records_nv raw_records_aqmon_nv raw_records_aqmon_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv (baseline_samples_nv, ONLINE, True) <OMITTED> Number of samples used in baseline rms calculation
channel_map <OMITTED> (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) frozendict mapping subdetector to (min, max) channel number.
check_raw_record_overlaps_nv True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
coincidence_level_recorder_nv 3 <OMITTED> Required coincidence level.
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.
n_lone_records_nv 2 <OMITTED> Number of lone hits to be stored per channel for diagnostic reasons.
pre_trigger_time_nv 150 <OMITTED> Pretrigger time before coincidence window in ns.
resolving_time_recorder_nv 600 <OMITTED> Resolving time of the coincidence in ns.

lone_raw_records_nv

Description

Provided by plugin: nVETORecorder

Data kind: lone_raw_records_nv

Plugin which builds a software trigger based on records. The trigger is defined by a simple coincidence between pulse fragments within the specified resolving time. All records which do not fall into one of the coincidence windows are labeled as lone records for which we compute some average properties for monitoring purposes. Depending on the setting also a fixed number of the lone_records per channel are stored.

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

%3 raw_records_nv raw_records_nv raw_records_aqmon_nv raw_records_aqmon_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv (baseline_samples_nv, ONLINE, True) <OMITTED> Number of samples used in baseline rms calculation
channel_map <OMITTED> (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) frozendict mapping subdetector to (min, max) channel number.
check_raw_record_overlaps_nv True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
coincidence_level_recorder_nv 3 <OMITTED> Required coincidence level.
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.
n_lone_records_nv 2 <OMITTED> Number of lone hits to be stored per channel for diagnostic reasons.
pre_trigger_time_nv 150 <OMITTED> Pretrigger time before coincidence window in ns.
resolving_time_recorder_nv 600 <OMITTED> Resolving time of the coincidence in ns.

lone_raw_record_statistics_nv

Description

Provided by plugin: nVETORecorder

Data kind: lone_raw_record_statistics_nv

Plugin which builds a software trigger based on records. The trigger is defined by a simple coincidence between pulse fragments within the specified resolving time. All records which do not fall into one of the coincidence windows are labeled as lone records for which we compute some average properties for monitoring purposes. Depending on the setting also a fixed number of the lone_records per channel are stored.

Columns provided

Field name Data type Comment
time int64 Start time of the chunk
endtime int64 Endtime of the chunk
channel ('<i4', (120,)) Channel of the lone record
nfragments ('<i4', (120,)) Total number of lone record fragments
nhigherfragments ('<f8', (120,)) Number of higher order lone fragments
lone_record_area ('<f8', (120,)) Average area per waveform in ADC_count x samples
higher_lone_record_area ('<i8', (120,)) Average area of higher fragment lone records in ADC_count x samples
baseline_mean ('<f8', (120,)) Baseline mean of lone records in ADC_count
baseline_rms ('<f8', (120,)) Baseline spread of lone records in ADC_count

Dependencies

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv (baseline_samples_nv, ONLINE, True) <OMITTED> Number of samples used in baseline rms calculation
channel_map <OMITTED> (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) frozendict mapping subdetector to (min, max) channel number.
check_raw_record_overlaps_nv True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
coincidence_level_recorder_nv 3 <OMITTED> Required coincidence level.
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.
n_lone_records_nv 2 <OMITTED> Number of lone hits to be stored per channel for diagnostic reasons.
pre_trigger_time_nv 150 <OMITTED> Pretrigger time before coincidence window in ns.
resolving_time_recorder_nv 600 <OMITTED> Resolving time of the coincidence in ns.

records_nv

Description

Provided by plugin: nVETOPulseProcessing

Data kind: records_nv

nVETO equivalent of pulse processing. The following steps are applied:

  1. Flip, baseline and integrate waveforms.

  2. Find hits and apply ZLE

  3. 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

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv (baseline_samples_nv, ONLINE, True) <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 used in baseline rms calculation
channel_map <OMITTED> (tpc, he, aqmon, aqmon_nv, tpc_blank, mv, aux_mv, mv_blank, nveto, nveto_blank) frozendict mapping subdetector to (min, max) channel number.
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_nv True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
coincidence_level_recorder_nv 3 <OMITTED> Required coincidence level.
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_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.
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.
n_lone_records_nv 2 <OMITTED> Number of lone hits to be stored per channel for diagnostic reasons.
pre_trigger_time_nv 150 <OMITTED> Pretrigger time before coincidence window in ns.
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
resolving_time_recorder_nv 600 <OMITTED> Resolving time of the coincidence in ns.
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_nv (3, 15) <OMITTED> Save (left, right) samples besides hits; cut the rest

hitlets_nv

Description

Provided by plugin: nVETOHitlets

Data kind: hitlets_nv

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:

  1. 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.

  2. 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

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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_nv False <OMITTED> Parameter which decides if data is first squared before normalized and compared to the template.
entropy_template_nv flat <OMITTED> Template data is compared with in conditional entropy. Can be either "flat" or an template array.
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_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_nv 0.063 <OMITTED> Minimum height difference pe/sample between local minimum and maximum, that a pulse get split.
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_nv (3, 15) <OMITTED> Save (left, right) samples besides hits; cut the rest

event_positions_nv

Description

Provided by plugin: nVETOEventPositions

Data kind: events_nv

Plugin which computes the interaction position in the nveto as an azimuthal angle.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
n_prompt_hitlets int16 Number of prompt hitlets within the first "position_max_time_nv" ns of the event.
angle float32 Azimuthal angle, where the neutron capture was detected in [0, 2 pi).
pos_x float32 Area weighted mean of position in x [mm]
pos_y float32 Area weighted mean of position in y [mm]
pos_z float32 Area weighted mean of position in z [mm]
pos_x_spread float32 Weighted variance of position in x [mm]
pos_y_spread float32 Weighted variance of position in y [mm]
pos_z_spread float32 Weighted variance of position in z [mm]

Dependencies

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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
nveto_pmt_position_map nveto_pmt_position.csv <OMITTED> nVeto PMT position mapfile
position_max_time_nv 20 <OMITTED> Time [ns] within an event use to compute the azimuthal angle of the event.

online_monitor_nv

Description

Provided by plugin: OnlineMonitorNV

Data kind: online_monitor_nv

Plugin to write data of nVeto detector to the online-monitor. Data that is written by this plugin should be small (~MB/chunk) to not overload the runs-database.

This plugin takes ‘hitlets_nv’ and ‘events_nv’. Although they are not strictly related, they are aggregated into a single data_type in order to minimize the number of documents in the online monitor.

Produces ‘online_monitor_nv’ with info on the hitlets_nv and events_nv

Columns provided

Field name Data type Comment
time int64 Start time of the chunk
endtime int64 End time of the chunk
hitlets_nv_per_channel ('<i8', (120,)) hitlets_nv per channel
events_nv_per_chunk int64 events_nv per chunk

Dependencies

%3 raw_records_nv raw_records_nv veto_regions_nv veto_regions_nv events_nv events_nv veto_regions_nv->events_nv hitlets_nv hitlets_nv events_nv->hitlets_nv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_coin_nv->raw_records_nv lone_raw_records_nv lone_raw_records_nv lone_raw_records_nv->raw_records_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv lone_raw_record_statistics_nv->raw_records_nv event_positions_nv event_positions_nv event_positions_nv->events_nv event_positions_nv->hitlets_nv online_monitor_nv online_monitor_nv online_monitor_nv->events_nv online_monitor_nv->hitlets_nv

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.