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.

events_sync_nv

Description

Provided by plugin: nVETOEventsSync

Data kind: events_nv

Plugin which computes time stamps which are synchronized with the TPC. Uses delay set in the DAQ.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
time_sync int64 Time of the event synchronized according to the total digitizer delay.
endtime_sync int64 Endtime of the event synchronized according to the total digitizer delay.

Dependencies

%3 events_sync_nv events_sync_nv events_nv events_nv events_sync_nv->events_nv detector_time_offsets detector_time_offsets events_sync_nv->detector_time_offsets hitlets_nv hitlets_nv events_nv->hitlets_nv raw_records_aqmon raw_records_aqmon detector_time_offsets->raw_records_aqmon raw_records_aqmon_nv raw_records_aqmon_nv detector_time_offsets->raw_records_aqmon_nv raw_records_aux_mv raw_records_aux_mv detector_time_offsets->raw_records_aux_mv records_nv records_nv hitlets_nv->records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_nv raw_records_nv raw_records_coin_nv->raw_records_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

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 since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
hitlets_nv_per_channel ('<i8', (120,)) hitlets_nv per channel
events_nv_area_per_chunk ('<i8', (131,)) events_nv_area per chunk
events_nv_per_chunk int64 events_nv per chunk
events_nv_4coinc_per_chunk int64 events_nv 4-coincidence per chunk
events_nv_5coinc_per_chunk int64 events_nv 5-coincidence per chunk
events_nv_8coinc_per_chunk int64 events_nv 8-coincidence per chunk
events_nv_10coinc_per_chunk int64 events_nv 10-coincidence per chunk

Dependencies

%3 online_monitor_nv online_monitor_nv hitlets_nv hitlets_nv online_monitor_nv->hitlets_nv events_nv events_nv online_monitor_nv->events_nv records_nv records_nv hitlets_nv->records_nv events_nv->hitlets_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_nv raw_records_nv raw_records_coin_nv->raw_records_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.
events_area_bounds (-0.5, 130.5) <OMITTED> Boundaries area histogram of events_nv_area_per_chunk [PE]
events_area_nbins 131 <OMITTED> Number of bins of histogram of events_nv_area_per_chunk, defined value 1 PE/bin

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 event_positions_nv event_positions_nv events_nv events_nv event_positions_nv->events_nv hitlets_nv hitlets_nv event_positions_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_nv raw_records_nv raw_records_coin_nv->raw_records_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 resource:/...sv?fmt=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.

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 events_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_nv raw_records_nv raw_records_coin_nv->raw_records_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 event window 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 200 <OMITTED> Resolving time for window coincidence [ns].

ext_timings_nv

Description

Provided by plugin: nVetoExtTimings

Data kind: hitlets_nv

Plugin which computes the time difference delta_time from pulse timing of hitlets_nv to start time of raw_records which belong the hitlets_nv. They are used as the external trigger timings.

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]
delta_time int16 Delta time from trigger timing [ns]
pulse_i int32 Index to which pulse (not record) the hitlet belongs to.

Dependencies

%3 ext_timings_nv ext_timings_nv raw_records_nv raw_records_nv ext_timings_nv->raw_records_nv hitlets_nv hitlets_nv ext_timings_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

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.

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 hitlets_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_nv raw_records_nv raw_records_coin_nv->raw_records_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 cmt://to_p...gin.run_id cmt://to_pe_model_nv?version=ONLINE&run_id=plugin.run_id PMT gain model. Specify as (model_type, model_config, nT = True)
hit_min_amplitude_nv cmt://hit_...gin.run_id <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

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 records_nv records_nv raw_records_coin_nv raw_records_coin_nv records_nv->raw_records_coin_nv raw_records_nv raw_records_nv raw_records_coin_nv->raw_records_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 cmt://base...gin.run_id <OMITTED> Number of samples to use at the start of the pulse to determine the baseline
baseline_samples_nv cmt://base...gin.run_id <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
hit_min_amplitude_nv cmt://hit_...gin.run_id <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 cmt://hit_...gin.run_id <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.
save_outside_hits_nv (3, 15) <OMITTED> Save (left, right) samples besides hits; cut the rest

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_coin_nv raw_records_coin_nv raw_records_nv raw_records_nv raw_records_coin_nv->raw_records_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 cmt://base...gin.run_id <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 cmt://hit_...gin.run_id <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 lone_raw_records_nv lone_raw_records_nv raw_records_nv raw_records_nv lone_raw_records_nv->raw_records_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 cmt://base...gin.run_id <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 cmt://hit_...gin.run_id <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 lone_raw_record_statistics_nv lone_raw_record_statistics_nv raw_records_nv raw_records_nv lone_raw_record_statistics_nv->raw_records_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 cmt://base...gin.run_id <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 cmt://hit_...gin.run_id <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.

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

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 cmt://base...gin.run_id <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
hit_min_amplitude_nv cmt://hit_...gin.run_id <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_aqmon_nv raw_records_aqmon_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
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.