Straxen nT datastructure

This page is an autogenerated reference for all the plugins in straxen’s xenonnt_online context.

The figures presented are dependency diagrams, meaning that an arrow stemming from a node points to a node that the stem depends on (i.e. “A depends on B” is equivalent to “A —> B”).

Colors indicate data kinds. To load tables with different data kinds, you currently need more than one get_df (or get_array) commands.

event_ms_naive

Description

Provided by plugin: EventInfoMS

Data kind: events

Plugin to collect multiple-scatter event observables.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
s1_sum float32 Sum of S1 areas in event
cs1_multi float32 Corrected S1 area based on average position of S2s in event
cs1_multi_wo_timecorr float32 Corrected S1 area based on average position of S2s in event before time-dep LY correction
s2_sum float32 Sum of S2 areas in event
cs2_sum float32 Sum of corrected S2 areas in event
cs2_wo_timecorr_sum float32 Sum of corrected S2 areas in event S2 before elife correction
cs2_wo_elifecorr_sum float32 Sum of corrected S2 areas in event before SEG/EE and elife corrections
cs2_area_fraction_top_avg float32 Average of S2 area fraction top in event
ces_sum float32 Sum of the energy estimates in event
e_charge_sum float32 Sum of the charge estimates in event
x_avg float32 Average x position of S2s in event
y_avg float32 Average y position of S2s in event
z_obs_avg float32 Average observed z position of energy deposits in event
multiplicity int32 Number of S2s in event

Dependencies

%3 event_ms_naive event_ms_naive event_info event_info event_ms_naive->event_info peak_basics peak_basics event_ms_naive->peak_basics peak_per_event peak_per_event event_ms_naive->peak_per_event peak_corrections peak_corrections event_ms_naive->peak_corrections peak_positions peak_positions event_ms_naive->peak_positions event_basics event_basics event_info->event_basics event_positions event_positions event_info->event_positions corrected_areas corrected_areas event_info->corrected_areas energy_estimates energy_estimates event_info->energy_estimates peaks peaks peak_basics->peaks peak_per_event->peak_basics peak_per_event->peak_positions peak_per_event->event_basics peak_corrections->peak_basics peak_corrections->peak_per_event peak_corrections->peak_positions peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn event_basics->peak_basics event_basics->peak_positions events events event_basics->events peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics corrected_areas->event_basics corrected_areas->event_positions energy_estimates->corrected_areas events->peak_basics events->peak_proximity peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
g1 bodega://g1?bodega_version=v2 <OMITTED> S1 gain in PE / photons produced
g2 bodega://g2?bodega_version=v2 <OMITTED> S2 gain in PE / electrons produced
lxe_w 0.0137 <OMITTED> LXe work function in quanta/keV
max_drift_length 148.6515 <OMITTED> Total length of the TPC from the bottom of gate to the top of cathode wires [cm]
ms_window_fac 1.01 <OMITTED> Max drift time window to look for peaks in multiple scatter events

event_info_double

Description

Provided by plugin: EventInfoDouble

Data kind: events

Alternate version of event_info for Kr and other double scatter.

analyses:

  • Uses a different naming convention: s1 -> s1_a, alt_s1 -> s1_b, and similarly for s2s;

  • Adds s1_b_distinct_channels, which can be tricky to compute (since it requires going back to peaks)

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
cs1_a float32 Corrected area of main S1 [PE]
cs1_a_wo_timecorr float32 Corrected area of main S1 (before LY correction) [PE]
cs2_a_wo_timecorr float32 Corrected area of main S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
cs2_area_fraction_top_wo_timecorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before SEG/EE + photon ionization, after S2 xy + elife)
cs2_wo_picorr float32 Corrected area of main S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
cs2_area_fraction_top_wo_picorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_a_wo_elifecorr float32 Corrected area of main S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
cs2_area_fraction_top_wo_elifecorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2_a float32 Corrected area of main S2 [PE]
cs2_a_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected main S2
cs1_b float32 Corrected area of alternate S1 [PE]
cs1_b_wo_timecorr float32 Corrected area of alternate S1 (before LY correction) [PE]
cs2_b_wo_timecorr float32 Corrected area of alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
alt_cs2_area_fraction_top_wo_timecorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife)
alt_cs2_wo_picorr float32 Corrected area of alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
alt_cs2_area_fraction_top_wo_picorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_b_wo_elifecorr float32 Corrected area of alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
alt_cs2_area_fraction_top_wo_elifecorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2_b float32 Corrected area of alternate S2 [PE]
cs2_b_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected alternate S2
e_light float32 Energy in light signal [keVee]
e_charge float32 Energy in charge signal [keVee]
e_ces float32 Energy estimate [keVee]
n_peaks int32 Number of peaks in the event
drift_time float32 Drift time between main S1 and S2 in ns
event_number int64 Event number in this dataset
s1_a_index int32 Main S1 peak index in event
s1_b_index int32 Alternate S1 peak index in event
s1_a_time int64 Main S1 start time since unix epoch [ns]
s1_b_time int64 Alternate S1 start time since unix epoch [ns]
s1_a_center_time int64 Main S1 weighted center time since unix epoch [ns]
s1_b_center_time int64 Alternate S1 weighted center time since unix epoch [ns]
s1_a_endtime int64 Main S1 end time since unix epoch [ns]
s1_b_endtime int64 Alternate S1 end time since unix epoch [ns]
s1_a_area float32 Main S1 area, uncorrected [PE]
s1_b_area float32 Alternate S1 area, uncorrected [PE]
s1_a_n_channels int16 Main S1 count of contributing PMTs
s1_b_n_channels int16 Alternate S1 count of contributing PMTs
s1_a_n_hits int16 Main S1 count of hits contributing at least one sample to the peak
s1_b_n_hits int16 Alternate S1 count of hits contributing at least one sample to the peak
s1_a_n_competing int32 Main S1 number of competing peaks
s1_b_n_competing int32 Alternate S1 number of competing peaks
s1_a_max_pmt int16 Main S1 PMT number which contributes the most PE
s1_b_max_pmt int16 Alternate S1 PMT number which contributes the most PE
s1_a_max_pmt_area float32 Main S1 area in the largest-contributing PMT (PE)
s1_b_max_pmt_area float32 Alternate S1 area in the largest-contributing PMT (PE)
s1_a_range_50p_area float32 Main S1 width, 50% area [ns]
s1_b_range_50p_area float32 Alternate S1 width, 50% area [ns]
s1_a_range_90p_area float32 Main S1 width, 90% area [ns]
s1_b_range_90p_area float32 Alternate S1 width, 90% area [ns]
s1_a_rise_time float32 Main S1 time between 10% and 50% area quantiles [ns]
s1_b_rise_time float32 Alternate S1 time between 10% and 50% area quantiles [ns]
s1_a_area_fraction_top float32 Main S1 fraction of area seen by the top PMT array
s1_b_area_fraction_top float32 Alternate S1 fraction of area seen by the top PMT array
s1_a_tight_coincidence int16 Main S1 Channel within tight range of mean
s1_b_tight_coincidence int16 Alternate S1 Channel within tight range of mean
s1_a_n_saturated_channels int16 Main S1 Total number of saturated channels
s1_b_n_saturated_channels int16 Alternate S1 Total number of saturated channels
s1_b_interaction_drift_time float32 Drift time using alternate S1 [ns]
ds_s1_dt int32 Time between main and alternate S1 [ns]
s2_a_index int32 Main S2 peak index in event
s2_b_index int32 Alternate S2 peak index in event
s2_a_time int64 Main S2 start time since unix epoch [ns]
s2_b_time int64 Alternate S2 start time since unix epoch [ns]
s2_a_center_time int64 Main S2 weighted center time since unix epoch [ns]
s2_b_center_time int64 Alternate S2 weighted center time since unix epoch [ns]
s2_a_endtime int64 Main S2 end time since unix epoch [ns]
s2_b_endtime int64 Alternate S2 end time since unix epoch [ns]
s2_a_area float32 Main S2 area, uncorrected [PE]
s2_b_area float32 Alternate S2 area, uncorrected [PE]
s2_a_n_channels int16 Main S2 count of contributing PMTs
s2_b_n_channels int16 Alternate S2 count of contributing PMTs
s2_a_n_hits int16 Main S2 count of hits contributing at least one sample to the peak
s2_b_n_hits int16 Alternate S2 count of hits contributing at least one sample to the peak
s2_a_n_competing int32 Main S2 number of competing peaks
s2_b_n_competing int32 Alternate S2 number of competing peaks
s2_a_max_pmt int16 Main S2 PMT number which contributes the most PE
s2_b_max_pmt int16 Alternate S2 PMT number which contributes the most PE
s2_a_max_pmt_area float32 Main S2 area in the largest-contributing PMT (PE)
s2_b_max_pmt_area float32 Alternate S2 area in the largest-contributing PMT (PE)
s2_a_range_50p_area float32 Main S2 width, 50% area [ns]
s2_b_range_50p_area float32 Alternate S2 width, 50% area [ns]
s2_a_range_90p_area float32 Main S2 width, 90% area [ns]
s2_b_range_90p_area float32 Alternate S2 width, 90% area [ns]
s2_a_rise_time float32 Main S2 time between 10% and 50% area quantiles [ns]
s2_b_rise_time float32 Alternate S2 time between 10% and 50% area quantiles [ns]
s2_a_area_fraction_top float32 Main S2 fraction of area seen by the top PMT array
s2_b_area_fraction_top float32 Alternate S2 fraction of area seen by the top PMT array
s2_a_tight_coincidence int16 Main S2 Channel within tight range of mean
s2_b_tight_coincidence int16 Alternate S2 Channel within tight range of mean
s2_a_n_saturated_channels int16 Main S2 Total number of saturated channels
s2_b_n_saturated_channels int16 Alternate S2 Total number of saturated channels
s2_b_interaction_drift_time float32 Drift time using alternate S2 [ns]
ds_s2_dt int32 Time between main and alternate S2 [ns]
s1_a_max_diff int32 Main S1 largest time difference between apexes of hits [ns]
s1_b_max_diff int32 Alternate S1 largest time difference between apexes of hits [ns]
s1_a_min_diff int32 Main S1 smallest time difference between apexes of hits [ns]
s1_b_min_diff int32 Alternate S1 smallest time difference between apexes of hits [ns]
s2_a_x float32 Main S2 reconstructed X position, uncorrected [cm]
s2_a_y float32 Main S2 reconstructed Y position, uncorrected [cm]
s2_b_x float32 Alternate S2 reconstructed X position, uncorrected [cm]
s2_b_y float32 Alternate S2 reconstructed Y position, uncorrected [cm]
area_before_main_s2 float32 Sum of areas before Main S2 [PE]
large_s2_before_main_s2 float32 The largest S2 before the Main S2 [PE]
s2_a_x_cnn float32 Main S2 cnn-reconstructed X position, uncorrected [cm]
s2_a_y_cnn float32 Main S2 cnn-reconstructed Y position, uncorrected [cm]
s2_b_x_cnn float32 Alternate S2 cnn-reconstructed X position, uncorrected [cm]
s2_b_y_cnn float32 Alternate S2 cnn-reconstructed Y position, uncorrected [cm]
s2_a_x_gcn float32 Main S2 gcn-reconstructed X position, uncorrected [cm]
s2_a_y_gcn float32 Main S2 gcn-reconstructed Y position, uncorrected [cm]
s2_b_x_gcn float32 Alternate S2 gcn-reconstructed X position, uncorrected [cm]
s2_b_y_gcn float32 Alternate S2 gcn-reconstructed Y position, uncorrected [cm]
s2_a_x_mlp float32 Main S2 mlp-reconstructed X position, uncorrected [cm]
s2_a_y_mlp float32 Main S2 mlp-reconstructed Y position, uncorrected [cm]
s2_b_x_mlp float32 Alternate S2 mlp-reconstructed X position, uncorrected [cm]
s2_b_y_mlp float32 Alternate S2 mlp-reconstructed Y position, uncorrected [cm]
x float32 Main interaction x-position, field-distortion corrected (cm)
s1_b_x_fdc float32 Alternative S1 interaction (rel. main S2) x-position, field-distortion corrected (cm)
s2_b_x_fdc float32 Alternative S2 interaction (rel. main S1) x-position, field-distortion corrected (cm)
y float32 Main interaction y-position, field-distortion corrected (cm)
s1_b_y_fdc float32 Alternative S1 interaction (rel. main S2) y-position, field-distortion corrected (cm)
s2_b_y_fdc float32 Alternative S2 interaction (rel. main S1) y-position, field-distortion corrected (cm)
r float32 Main interaction r-position, field-distortion corrected (cm)
s1_b_r_fdc float32 Alternative S1 interaction (rel. main S2) r-position, field-distortion corrected (cm)
s2_b_r_fdc float32 Alternative S2 interaction (rel. main S1) r-position, field-distortion corrected (cm)
z float32 Interaction z-position, corrected to non-uniform drift velocity (cm)
z_dv_corr float32 Interaction z-position, corrected to non-uniform drift velocity, duplicated (cm)
s1_b_z float32 Alternative S1 z-position (rel. main S2), corrected to non-uniform drift velocity (cm)
s1_b_z_dv_corr float32 Alternative S1 z-position (rel. main S2), corrected to non-uniform drift velocity, duplicated (cm)
s2_b_z float32 Alternative S2 z-position (rel. main S1), corrected to non-uniform drift velocity (cm)
s2_b_z_dv_corr float32 Alternative S2 z-position (rel. main S1), corrected to non-uniform drift velocity, duplicated (cm)
r_naive float32 Main interaction r-position with observed position (cm)
s1_b_r_naive float32 Alternative S1 interaction (rel. main S2) r-position with observed position (cm)
s2_b_r_naive float32 Alternative S2 interaction (rel. main S1) r-position with observed position (cm)
z_naive float32 Main interaction z-position with observed position (cm)
s1_b_z_naive float32 Alternative S1 interaction (rel. main S2) z-position with observed position (cm)
s2_b_z_naive float32 Alternative S2 interaction (rel. main S1) z-position with observed position (cm)
r_field_distortion_correction float32 Correction added to r_naive for field distortion (cm)
s1_b_r_field_distortion_correction float32 Correction added to alt_s1_r_naive for field distortion (cm)
s2_b_r_field_distortion_correction float32 Correction added to alt_s2_r_naive for field distortion (cm)
z_field_distortion_correction float32 Correction added to z_naive for field distortion (cm)
s1_b_z_field_distortion_correction float32 Correction added to alt_s1_z_naive for field distortion (cm)
s2_b_z_field_distortion_correction float32 Correction added to alt_s2_z_naive for field distortion (cm)
s1_b_theta float32 Alternative S1 (rel. main S2) interaction angular position (radians)
s2_b_theta float32 Alternative S2 (rel. main S1) interaction angular position (radians)
theta float32 Main interaction angular position (radians)
s1_b_distinct_channels int32 Number of PMTs contributing to the secondary S1 that do not contribute to the main S1

Dependencies

%3 event_info_double event_info_double event_info event_info event_info_double->event_info distinct_channels distinct_channels event_info_double->distinct_channels event_basics event_basics event_info->event_basics event_positions event_positions event_info->event_positions corrected_areas corrected_areas event_info->corrected_areas energy_estimates energy_estimates event_info->energy_estimates distinct_channels->event_basics peaks peaks distinct_channels->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics corrected_areas->event_basics corrected_areas->event_positions energy_estimates->corrected_areas events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

event_top_bottom_params

Description

Provided by plugin: EventTopBottomParams

Data kind: events

Pluging that computes timing characteristics of top and bottom waveforms based on waveforms

stored at event level for main/alt S1/S2.

Columns provided

Field name Data type Comment
s1_center_time_top int64 Central time for main S1 for top PMTs [ ns ]
s1_rise_time_top float32 Time between 10% and 50% area quantiles for main S1 for top PMTs [ns]
s1_range_50p_area_top float32 Width (in ns) of the central 50% area of the peak for top PMTs of main S1
s1_range_90p_area_top float32 Width (in ns) of the central 90% area of the peak for top PMTs of main S1
s1_center_time_bot int64 Central time for main S1 for bot PMTs [ ns ]
s1_rise_time_bot float32 Time between 10% and 50% area quantiles for main S1 for bot PMTs [ns]
s1_range_50p_area_bot float32 Width (in ns) of the central 50% area of the peak for bot PMTs of main S1
s1_range_90p_area_bot float32 Width (in ns) of the central 90% area of the peak for bot PMTs of main S1
s1_center_time_diff_top_bot int64 Difference between center times of top and bottom arrays for main S1 [ ns ]
s2_center_time_top int64 Central time for main S2 for top PMTs [ ns ]
s2_rise_time_top float32 Time between 10% and 50% area quantiles for main S2 for top PMTs [ns]
s2_range_50p_area_top float32 Width (in ns) of the central 50% area of the peak for top PMTs of main S2
s2_range_90p_area_top float32 Width (in ns) of the central 90% area of the peak for top PMTs of main S2
s2_center_time_bot int64 Central time for main S2 for bot PMTs [ ns ]
s2_rise_time_bot float32 Time between 10% and 50% area quantiles for main S2 for bot PMTs [ns]
s2_range_50p_area_bot float32 Width (in ns) of the central 50% area of the peak for bot PMTs of main S2
s2_range_90p_area_bot float32 Width (in ns) of the central 90% area of the peak for bot PMTs of main S2
s2_center_time_diff_top_bot int64 Difference between center times of top and bottom arrays for main S2 [ ns ]
alt_s1_center_time_top int64 Central time for alternative S1 for top PMTs [ ns ]
alt_s1_rise_time_top float32 Time between 10% and 50% area quantiles for alternative S1 for top PMTs [ns]
alt_s1_range_50p_area_top float32 Width (in ns) of the central 50% area of the peak for top PMTs of alternative S1
alt_s1_range_90p_area_top float32 Width (in ns) of the central 90% area of the peak for top PMTs of alternative S1
alt_s1_center_time_bot int64 Central time for alternative S1 for bot PMTs [ ns ]
alt_s1_rise_time_bot float32 Time between 10% and 50% area quantiles for alternative S1 for bot PMTs [ns]
alt_s1_range_50p_area_bot float32 Width (in ns) of the central 50% area of the peak for bot PMTs of alternative S1
alt_s1_range_90p_area_bot float32 Width (in ns) of the central 90% area of the peak for bot PMTs of alternative S1
alt_s1_center_time_diff_top_bot int64 Difference between center times of top and bottom arrays for alternative S1 [ ns ]
alt_s2_center_time_top int64 Central time for alternative S2 for top PMTs [ ns ]
alt_s2_rise_time_top float32 Time between 10% and 50% area quantiles for alternative S2 for top PMTs [ns]
alt_s2_range_50p_area_top float32 Width (in ns) of the central 50% area of the peak for top PMTs of alternative S2
alt_s2_range_90p_area_top float32 Width (in ns) of the central 90% area of the peak for top PMTs of alternative S2
alt_s2_center_time_bot int64 Central time for alternative S2 for bot PMTs [ ns ]
alt_s2_rise_time_bot float32 Time between 10% and 50% area quantiles for alternative S2 for bot PMTs [ns]
alt_s2_range_50p_area_bot float32 Width (in ns) of the central 50% area of the peak for bot PMTs of alternative S2
alt_s2_range_90p_area_bot float32 Width (in ns) of the central 90% area of the peak for bot PMTs of alternative S2
alt_s2_center_time_diff_top_bot int64 Difference between center times of top and bottom arrays for alternative S2 [ ns ]
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_top_bottom_params event_top_bottom_params event_info event_info event_top_bottom_params->event_info event_waveform event_waveform event_top_bottom_params->event_waveform event_basics event_basics event_info->event_basics event_positions event_positions event_info->event_positions corrected_areas corrected_areas event_info->corrected_areas energy_estimates energy_estimates event_info->energy_estimates event_waveform->event_basics peaks peaks event_waveform->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics corrected_areas->event_basics corrected_areas->event_positions energy_estimates->corrected_areas events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

event_info

Description

Provided by plugin: EventInfo

Data kind: events

Plugin which merges the information of all event data_kinds into a single data_type.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
cs1 float32 Corrected area of main S1 [PE]
cs1_wo_timecorr float32 Corrected area of main S1 (before LY correction) [PE]
cs2_wo_timecorr float32 Corrected area of main S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
cs2_area_fraction_top_wo_timecorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before SEG/EE + photon ionization, after S2 xy + elife)
cs2_wo_picorr float32 Corrected area of main S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
cs2_area_fraction_top_wo_picorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_wo_elifecorr float32 Corrected area of main S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
cs2_area_fraction_top_wo_elifecorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2 float32 Corrected area of main S2 [PE]
cs2_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected main S2
alt_cs1 float32 Corrected area of alternate S1 [PE]
alt_cs1_wo_timecorr float32 Corrected area of alternate S1 (before LY correction) [PE]
alt_cs2_wo_timecorr float32 Corrected area of alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
alt_cs2_area_fraction_top_wo_timecorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife)
alt_cs2_wo_picorr float32 Corrected area of alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
alt_cs2_area_fraction_top_wo_picorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE)
alt_cs2_wo_elifecorr float32 Corrected area of alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
alt_cs2_area_fraction_top_wo_elifecorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization)
alt_cs2 float32 Corrected area of alternate S2 [PE]
alt_cs2_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected alternate S2
e_light float32 Energy in light signal [keVee]
e_charge float32 Energy in charge signal [keVee]
e_ces float32 Energy estimate [keVee]
n_peaks int32 Number of peaks in the event
drift_time float32 Drift time between main S1 and S2 in ns
event_number int64 Event number in this dataset
s1_index int32 Main S1 peak index in event
alt_s1_index int32 Alternate S1 peak index in event
s1_time int64 Main S1 start time since unix epoch [ns]
alt_s1_time int64 Alternate S1 start time since unix epoch [ns]
s1_center_time int64 Main S1 weighted center time since unix epoch [ns]
alt_s1_center_time int64 Alternate S1 weighted center time since unix epoch [ns]
s1_endtime int64 Main S1 end time since unix epoch [ns]
alt_s1_endtime int64 Alternate S1 end time since unix epoch [ns]
s1_area float32 Main S1 area, uncorrected [PE]
alt_s1_area float32 Alternate S1 area, uncorrected [PE]
s1_n_channels int16 Main S1 count of contributing PMTs
alt_s1_n_channels int16 Alternate S1 count of contributing PMTs
s1_n_hits int16 Main S1 count of hits contributing at least one sample to the peak
alt_s1_n_hits int16 Alternate S1 count of hits contributing at least one sample to the peak
s1_n_competing int32 Main S1 number of competing peaks
alt_s1_n_competing int32 Alternate S1 number of competing peaks
s1_max_pmt int16 Main S1 PMT number which contributes the most PE
alt_s1_max_pmt int16 Alternate S1 PMT number which contributes the most PE
s1_max_pmt_area float32 Main S1 area in the largest-contributing PMT (PE)
alt_s1_max_pmt_area float32 Alternate S1 area in the largest-contributing PMT (PE)
s1_range_50p_area float32 Main S1 width, 50% area [ns]
alt_s1_range_50p_area float32 Alternate S1 width, 50% area [ns]
s1_range_90p_area float32 Main S1 width, 90% area [ns]
alt_s1_range_90p_area float32 Alternate S1 width, 90% area [ns]
s1_rise_time float32 Main S1 time between 10% and 50% area quantiles [ns]
alt_s1_rise_time float32 Alternate S1 time between 10% and 50% area quantiles [ns]
s1_area_fraction_top float32 Main S1 fraction of area seen by the top PMT array
alt_s1_area_fraction_top float32 Alternate S1 fraction of area seen by the top PMT array
s1_tight_coincidence int16 Main S1 Channel within tight range of mean
alt_s1_tight_coincidence int16 Alternate S1 Channel within tight range of mean
s1_n_saturated_channels int16 Main S1 Total number of saturated channels
alt_s1_n_saturated_channels int16 Alternate S1 Total number of saturated channels
alt_s1_interaction_drift_time float32 Drift time using alternate S1 [ns]
alt_s1_delay int32 Time between main and alternate S1 [ns]
s2_index int32 Main S2 peak index in event
alt_s2_index int32 Alternate S2 peak index in event
s2_time int64 Main S2 start time since unix epoch [ns]
alt_s2_time int64 Alternate S2 start time since unix epoch [ns]
s2_center_time int64 Main S2 weighted center time since unix epoch [ns]
alt_s2_center_time int64 Alternate S2 weighted center time since unix epoch [ns]
s2_endtime int64 Main S2 end time since unix epoch [ns]
alt_s2_endtime int64 Alternate S2 end time since unix epoch [ns]
s2_area float32 Main S2 area, uncorrected [PE]
alt_s2_area float32 Alternate S2 area, uncorrected [PE]
s2_n_channels int16 Main S2 count of contributing PMTs
alt_s2_n_channels int16 Alternate S2 count of contributing PMTs
s2_n_hits int16 Main S2 count of hits contributing at least one sample to the peak
alt_s2_n_hits int16 Alternate S2 count of hits contributing at least one sample to the peak
s2_n_competing int32 Main S2 number of competing peaks
alt_s2_n_competing int32 Alternate S2 number of competing peaks
s2_max_pmt int16 Main S2 PMT number which contributes the most PE
alt_s2_max_pmt int16 Alternate S2 PMT number which contributes the most PE
s2_max_pmt_area float32 Main S2 area in the largest-contributing PMT (PE)
alt_s2_max_pmt_area float32 Alternate S2 area in the largest-contributing PMT (PE)
s2_range_50p_area float32 Main S2 width, 50% area [ns]
alt_s2_range_50p_area float32 Alternate S2 width, 50% area [ns]
s2_range_90p_area float32 Main S2 width, 90% area [ns]
alt_s2_range_90p_area float32 Alternate S2 width, 90% area [ns]
s2_rise_time float32 Main S2 time between 10% and 50% area quantiles [ns]
alt_s2_rise_time float32 Alternate S2 time between 10% and 50% area quantiles [ns]
s2_area_fraction_top float32 Main S2 fraction of area seen by the top PMT array
alt_s2_area_fraction_top float32 Alternate S2 fraction of area seen by the top PMT array
s2_tight_coincidence int16 Main S2 Channel within tight range of mean
alt_s2_tight_coincidence int16 Alternate S2 Channel within tight range of mean
s2_n_saturated_channels int16 Main S2 Total number of saturated channels
alt_s2_n_saturated_channels int16 Alternate S2 Total number of saturated channels
alt_s2_interaction_drift_time float32 Drift time using alternate S2 [ns]
alt_s2_delay int32 Time between main and alternate S2 [ns]
s1_max_diff int32 Main S1 largest time difference between apexes of hits [ns]
alt_s1_max_diff int32 Alternate S1 largest time difference between apexes of hits [ns]
s1_min_diff int32 Main S1 smallest time difference between apexes of hits [ns]
alt_s1_min_diff int32 Alternate S1 smallest time difference between apexes of hits [ns]
s2_x float32 Main S2 reconstructed X position, uncorrected [cm]
s2_y float32 Main S2 reconstructed Y position, uncorrected [cm]
alt_s2_x float32 Alternate S2 reconstructed X position, uncorrected [cm]
alt_s2_y float32 Alternate S2 reconstructed Y position, uncorrected [cm]
area_before_main_s2 float32 Sum of areas before Main S2 [PE]
large_s2_before_main_s2 float32 The largest S2 before the Main S2 [PE]
s2_x_cnn float32 Main S2 cnn-reconstructed X position, uncorrected [cm]
s2_y_cnn float32 Main S2 cnn-reconstructed Y position, uncorrected [cm]
alt_s2_x_cnn float32 Alternate S2 cnn-reconstructed X position, uncorrected [cm]
alt_s2_y_cnn float32 Alternate S2 cnn-reconstructed Y position, uncorrected [cm]
s2_x_gcn float32 Main S2 gcn-reconstructed X position, uncorrected [cm]
s2_y_gcn float32 Main S2 gcn-reconstructed Y position, uncorrected [cm]
alt_s2_x_gcn float32 Alternate S2 gcn-reconstructed X position, uncorrected [cm]
alt_s2_y_gcn float32 Alternate S2 gcn-reconstructed Y position, uncorrected [cm]
s2_x_mlp float32 Main S2 mlp-reconstructed X position, uncorrected [cm]
s2_y_mlp float32 Main S2 mlp-reconstructed Y position, uncorrected [cm]
alt_s2_x_mlp float32 Alternate S2 mlp-reconstructed X position, uncorrected [cm]
alt_s2_y_mlp float32 Alternate S2 mlp-reconstructed Y position, uncorrected [cm]
x float32 Main interaction x-position, field-distortion corrected (cm)
alt_s1_x_fdc float32 Alternative S1 interaction (rel. main S2) x-position, field-distortion corrected (cm)
alt_s2_x_fdc float32 Alternative S2 interaction (rel. main S1) x-position, field-distortion corrected (cm)
y float32 Main interaction y-position, field-distortion corrected (cm)
alt_s1_y_fdc float32 Alternative S1 interaction (rel. main S2) y-position, field-distortion corrected (cm)
alt_s2_y_fdc float32 Alternative S2 interaction (rel. main S1) y-position, field-distortion corrected (cm)
r float32 Main interaction r-position, field-distortion corrected (cm)
alt_s1_r_fdc float32 Alternative S1 interaction (rel. main S2) r-position, field-distortion corrected (cm)
alt_s2_r_fdc float32 Alternative S2 interaction (rel. main S1) r-position, field-distortion corrected (cm)
z float32 Interaction z-position, corrected to non-uniform drift velocity (cm)
z_dv_corr float32 Interaction z-position, corrected to non-uniform drift velocity, duplicated (cm)
alt_s1_z float32 Alternative S1 z-position (rel. main S2), corrected to non-uniform drift velocity (cm)
alt_s1_z_dv_corr float32 Alternative S1 z-position (rel. main S2), corrected to non-uniform drift velocity, duplicated (cm)
alt_s2_z float32 Alternative S2 z-position (rel. main S1), corrected to non-uniform drift velocity (cm)
alt_s2_z_dv_corr float32 Alternative S2 z-position (rel. main S1), corrected to non-uniform drift velocity, duplicated (cm)
r_naive float32 Main interaction r-position with observed position (cm)
alt_s1_r_naive float32 Alternative S1 interaction (rel. main S2) r-position with observed position (cm)
alt_s2_r_naive float32 Alternative S2 interaction (rel. main S1) r-position with observed position (cm)
z_naive float32 Main interaction z-position with observed position (cm)
alt_s1_z_naive float32 Alternative S1 interaction (rel. main S2) z-position with observed position (cm)
alt_s2_z_naive float32 Alternative S2 interaction (rel. main S1) z-position with observed position (cm)
r_field_distortion_correction float32 Correction added to r_naive for field distortion (cm)
alt_s1_r_field_distortion_correction float32 Correction added to alt_s1_r_naive for field distortion (cm)
alt_s2_r_field_distortion_correction float32 Correction added to alt_s2_r_naive for field distortion (cm)
z_field_distortion_correction float32 Correction added to z_naive for field distortion (cm)
alt_s1_z_field_distortion_correction float32 Correction added to alt_s1_z_naive for field distortion (cm)
alt_s2_z_field_distortion_correction float32 Correction added to alt_s2_z_naive for field distortion (cm)
alt_s1_theta float32 Alternative S1 (rel. main S2) interaction angular position (radians)
alt_s2_theta float32 Alternative S2 (rel. main S1) interaction angular position (radians)
theta float32 Main interaction angular position (radians)

Dependencies

%3 event_info event_info event_basics event_basics event_info->event_basics event_positions event_positions event_info->event_positions corrected_areas corrected_areas event_info->corrected_areas energy_estimates energy_estimates event_info->energy_estimates events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics corrected_areas->event_basics corrected_areas->event_positions energy_estimates->corrected_areas events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
event_info_function pre_apply_function <OMITTED> Function that must be applied to all event_info data. Do not change.

event_pattern_fit

Description

Provided by plugin: EventPatternFit

Data kind: events

Plugin that provides patter information for events.

Columns provided

Field name Data type Comment
s2_2llh float32 Modified Poisson likelihood value for main S2 in the event
s2_neural_2llh float32 Data-driven based likelihood value for main S2 in the event
alt_s2_2llh float32 Modified Poisson likelihood value for alternative S2
alt_s2_neural_2llh float32 Data-driven based likelihood value for alternative S2 in the event
s1_2llh float32 Modified Poisson likelihood value for main S1
s1_top_2llh float32 Modified Poisson likelihood value for main S1, calculated from top array
s1_bottom_2llh float32 Modified Poisson likelihood value for main S1, calculated from bottom array
s1_area_fraction_top_continuous_probability float32 Continuous binomial test for S1 area fraction top
s1_area_fraction_top_discrete_probability float32 Discrete binomial test for S1 area fraction top
s1_photon_fraction_top_continuous_probability float32 Continuous binomial test for S1 photon fraction top
s1_photon_fraction_top_discrete_probability float32 Discrete binomial test for S1 photon fraction top
alt_s1_area_fraction_top_continuous_probability float32 Continuous binomial test for alternative S1 area fraction top
alt_s1_area_fraction_top_discrete_probability float32 Discrete binomial test for alternative S1 area fraction top
alt_s1_photon_fraction_top_continuous_probability float32 Continuous binomial test for alternative S1 photon fraction top
alt_s1_photon_fraction_top_discrete_probability float32 Discrete binomial test for alternative S1 photon fraction top
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_pattern_fit event_pattern_fit event_area_per_channel event_area_per_channel event_pattern_fit->event_area_per_channel event_basics event_basics event_pattern_fit->event_basics event_positions event_positions event_pattern_fit->event_positions event_area_per_channel->event_basics peaks peaks event_area_per_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
electron_drift_time_gate cmt://elec...gin.run_id <OMITTED> Electron drift time from the gate in ns
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
gain_model <OMITTED> cmt://to_pe_model?version=ONLINE&run_id=plugin.run_id PMT gain model. Specify as (model_type, model_config)
max_r_pattern_fit 66.4 <OMITTED> Maximal radius of the peaks where llh calculation will be performed
mean_pe_per_photon 1.2 <OMITTED> Mean of full VUV single photon response
n_top_pmts <OMITTED> 253 Number of top TPC PMTs
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
s1_aft_map itp_map://...d&fmt=json <OMITTED>
s1_min_area_pattern_fit 2 <OMITTED> Skip EventPatternFit reconstruction if S1 area (PE) is less than this
s1_optical_map itp_map://...kl?fmt=pkl <OMITTED> S1 (x, y, z) optical/pattern map.
s2_min_area_pattern_fit 10 <OMITTED> Skip EventPatternFit reconstruction if S2 area (PE) is less than this
s2_optical_map itp_map://...kl?fmt=pkl <OMITTED> S2 (x, y) optical/pattern map.
s2_tf_model tf://resou...t=abs_path <OMITTED> S2 (x, y) optical data-driven model
store_per_channel False <OMITTED> Store normalized LLH per channel for each peak

energy_estimates

Description

Provided by plugin: EnergyEstimates

Data kind: events

Plugin which converts cS1 and cS2 into energies (from PE to KeVee).

Columns provided

Field name Data type Comment
e_light float32 Energy in light signal [keVee]
e_charge float32 Energy in charge signal [keVee]
e_ces float32 Energy estimate [keVee]
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 energy_estimates energy_estimates corrected_areas corrected_areas energy_estimates->corrected_areas event_basics event_basics corrected_areas->event_basics event_positions event_positions corrected_areas->event_positions events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
g1 bodega://g1?bodega_version=v2 <OMITTED> S1 gain in PE / photons produced
g2 bodega://g2?bodega_version=v2 <OMITTED> S2 gain in PE / electrons produced
lxe_w 0.0137 <OMITTED> LXe work function in quanta/keV

event_s1_positions_cnn

Description

Provided by plugin: EventS1PositionCNN

Data kind: events

CNN for (x,y,z) position S1 reconstruction at event level.

Columns provided

Field name Data type Comment
event_x_s1_cnn float32 Reconstructed s1_cnn S1 X position (cm), uncorrected
event_y_s1_cnn float32 Reconstructed s1_cnn S1 Y position (cm), uncorrected
event_z_s1_cnn float32 Reconstructed s1_cnn S1 Z position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_s1_positions_cnn event_s1_positions_cnn event_area_per_channel event_area_per_channel event_s1_positions_cnn->event_area_per_channel event_basics event_basics event_s1_positions_cnn->event_basics event_area_per_channel->event_basics peaks peaks event_area_per_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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_s1_area_s1_posrec 1000 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_event_model_s1_cnn tf://resou...attr=value <OMITTED> s1 position 3d reconstruction cnn model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

event_s2_positions_cnn

Description

Provided by plugin: EventS2PositionCNN

Data kind: events

CNN for position S2 reconstruction at event level.

Columns provided

Field name Data type Comment
event_s2_x_cnn float32 Reconstructed cnn S2 X position (cm), uncorrected
event_s2_y_cnn float32 Reconstructed cnn S2 Y position (cm), uncorrected
event_alt_s2_x_cnn float32 Reconstructed cnn alt S2 X position (cm), uncorrected
event_alt_s2_y_cnn float32 Reconstructed cnn alt S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_s2_positions_cnn event_s2_positions_cnn event_area_per_channel event_area_per_channel event_s2_positions_cnn->event_area_per_channel event_basics event_basics event_s2_positions_cnn->event_basics event_area_per_channel->event_basics peaks peaks event_area_per_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_event_model_cnn tf://resou...t=abs_path <OMITTED> CNN model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

event_s2_positions_gcn

Description

Provided by plugin: EventS2PositionGCN

Data kind: events

GCN net for position S2 reconstruction at event level.

Columns provided

Field name Data type Comment
event_s2_x_gcn float32 Reconstructed gcn S2 X position (cm), uncorrected
event_s2_y_gcn float32 Reconstructed gcn S2 Y position (cm), uncorrected
event_alt_s2_x_gcn float32 Reconstructed gcn alt S2 X position (cm), uncorrected
event_alt_s2_y_gcn float32 Reconstructed gcn alt S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_s2_positions_gcn event_s2_positions_gcn event_area_per_channel event_area_per_channel event_s2_positions_gcn->event_area_per_channel event_basics event_basics event_s2_positions_gcn->event_basics event_area_per_channel->event_basics peaks peaks event_area_per_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_event_model_gcn tf://resou...t=abs_path <OMITTED> MLP model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

event_s2_positions_mlp

Description

Provided by plugin: EventS2PositionMLP

Data kind: events

MLP neural net for S2 position reconstruction at event level.

Columns provided

Field name Data type Comment
event_s2_x_mlp float32 Reconstructed mlp S2 X position (cm), uncorrected
event_s2_y_mlp float32 Reconstructed mlp S2 Y position (cm), uncorrected
event_alt_s2_x_mlp float32 Reconstructed mlp alt S2 X position (cm), uncorrected
event_alt_s2_y_mlp float32 Reconstructed mlp alt S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_s2_positions_mlp event_s2_positions_mlp event_area_per_channel event_area_per_channel event_s2_positions_mlp->event_area_per_channel event_basics event_basics event_s2_positions_mlp->event_basics event_area_per_channel->event_basics peaks peaks event_area_per_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_event_model_mlp tf://resou...t=abs_path <OMITTED> MLP model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

event_som_classification

Description

Provided by plugin: EventSOMClassification

Data kind: events

Plugin which propagates S1 SOM infromation to events as long straxen.PeakletClassification is

still used.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
s1_som_sub_type int32 Main S1 SOM subtype of the peak(let)
s1_som_type int8 Main S1 SOM type of the peak(let)
s1_loc_x_som int16 Main S1 x location of the peak(let) in the SOM
s1_loc_y_som int16 Main S1 y location of the peak(let) in the SOM
alt_s1_som_sub_type int32 Alt S1 SOM subtype of the peak(let)
alt_s1_som_type int8 Alt S1 SOM type of the peak(let)
alt_s1_loc_x_som int16 Alt S1 x location of the peak(let) in the SOM
alt_s1_loc_y_som int16 Alt S1 y location of the peak(let) in the SOM

Dependencies

%3 event_som_classification event_som_classification event_basics event_basics event_som_classification->event_basics peak_som_classification peak_som_classification event_som_classification->peak_som_classification events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peak_som_classification->peak_basics peaklet_classification_som peaklet_classification_som peak_som_classification->peaklet_classification_som events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks peaklet_classification_som->peaklets

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

veto_proximity

Description

Provided by plugin: VetoProximity

Data kind: events

Find the closest next/previous veto start w.r.t.

the event time or when a busy happens during an event.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
veto_busy_overlap int64 Duration of event overlapping with "busy"-veto [ns]
time_to_previous_busy int64 Time (absolute value) to previous "busy"-veto from "time" of event [ns]
time_to_next_busy int64 Time (absolute value) to next "busy"-veto from "endtime" of event [ns]
veto_busy_he_overlap int64 Duration of event overlapping with "busy_he"-veto [ns]
time_to_previous_busy_he int64 Time (absolute value) to previous "busy_he"-veto from "time" of event [ns]
time_to_next_busy_he int64 Time (absolute value) to next "busy_he"-veto from "endtime" of event [ns]
veto_hev_overlap int64 Duration of event overlapping with "hev"-veto [ns]
time_to_previous_hev int64 Time (absolute value) to previous "hev"-veto from "time" of event [ns]
time_to_next_hev int64 Time (absolute value) to next "hev"-veto from "endtime" of event [ns]
veto_straxen_deadtime_overlap int64 Duration of event overlapping with "straxen_deadtime"-veto [ns]
time_to_previous_straxen_deadtime int64 Time (absolute value) to previous "straxen_deadtime"-veto from "time" of event [ns]
time_to_next_straxen_deadtime int64 Time (absolute value) to next "straxen_deadtime"-veto from "endtime" of event [ns]

Dependencies

%3 veto_proximity veto_proximity event_basics event_basics veto_proximity->event_basics veto_intervals veto_intervals veto_proximity->veto_intervals events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity aqmon_hits aqmon_hits veto_intervals->aqmon_hits events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks raw_records_aqmon raw_records_aqmon aqmon_hits->raw_records_aqmon

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
event_window_fields (time, endtime) <OMITTED> Fields to determine where to look for overlaps for using this plugin in the events. The default uses start and endtime of an event, but this can also be the S1 or S2 start/endtime
time_no_aqmon_veto_found 3600000000000 <OMITTED> If no next/previous veto is found, we will fill the fields time_to_previous_XX with this time. Set to a large number such that one will never cut events that are < YY ns.
veto_proximity_window 300000000000 <OMITTED> Maximum separation between veto stop and start pulses [ns]

corrected_areas

Description

Provided by plugin: CorrectedAreas

Data kind: events

Plugin which applies light collection efficiency maps and electron life time to the data.

Computes the cS1/cS2 for the main/alternative S1/S2 as well as the corrected life time. Note:

Please be aware that for both, the main and alternative S1, the area is corrected according to the xy-position of the main S2. There are now 3 components of cS2s: cs2_top, cS2_bottom and cs2. cs2_top and cs2_bottom are corrected by the corresponding maps, and cs2 is the sum of the two.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
cs1 float32 Corrected area of main S1 [PE]
cs1_wo_timecorr float32 Corrected area of main S1 (before LY correction) [PE]
cs2_wo_timecorr float32 Corrected area of main S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
cs2_area_fraction_top_wo_timecorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before SEG/EE + photon ionization, after S2 xy + elife)
cs2_wo_picorr float32 Corrected area of main S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
cs2_area_fraction_top_wo_picorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_wo_elifecorr float32 Corrected area of main S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
cs2_area_fraction_top_wo_elifecorr float32 Fraction of area seen by the top PMT array for corrected main S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2 float32 Corrected area of main S2 [PE]
cs2_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected main S2
alt_cs1 float32 Corrected area of alternate S1 [PE]
alt_cs1_wo_timecorr float32 Corrected area of alternate S1 (before LY correction) [PE]
alt_cs2_wo_timecorr float32 Corrected area of alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
alt_cs2_area_fraction_top_wo_timecorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife)
alt_cs2_wo_picorr float32 Corrected area of alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
alt_cs2_area_fraction_top_wo_picorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE)
alt_cs2_wo_elifecorr float32 Corrected area of alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
alt_cs2_area_fraction_top_wo_elifecorr float32 Fraction of area seen by the top PMT array for corrected alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization)
alt_cs2 float32 Corrected area of alternate S2 [PE]
alt_cs2_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected alternate S2

Dependencies

%3 corrected_areas corrected_areas event_basics event_basics corrected_areas->event_basics event_positions event_positions corrected_areas->event_positions events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity event_positions->event_basics events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
avg_se_gain cmt://avg_...gin.run_id <OMITTED> Nominal single electron (SE) gain in PE / electron extracted. Data will be corrected to this value
cs2_bottom_top_ratio_correction 1 <OMITTED> Scaling factor for cS2 AFT correction due to photon ionization
default_reconstruction_algorithm mlp <OMITTED> default reconstruction algorithm that provides (x,y)
elife cmt://elif...gin.run_id <OMITTED> electron lifetime in [ns]
region_circular 60 <OMITTED> circular cut (cm) for ab region, check out the note https://xe1t-wiki.lngs.infn.it/doku.php?id=jlong:sr0_2_region_se_correction
region_linear 28 <OMITTED> linear cut (cm) for ab region, check out the note https://xe1t-wiki.lngs.infn.it/doku.php?id=jlong:sr0_2_region_se_correction
rel_extraction_eff cmt://rel_...gin.run_id <OMITTED> Relative extraction efficiency for this run (allows for time dependence)
rel_light_yield cmt://rela...gin.run_id <OMITTED> Relative light yield (allows for time dependence)
s1_xyz_map itp_map://..._algorithm <OMITTED>
s2_xy_map itp_map://..._algorithm <OMITTED>
se_gain cmt://se_g...gin.run_id <OMITTED> Actual SE gain for a given run (allows for time dependence)

event_ambience

Description

Provided by plugin: EventAmbience

Data kind: events

Save Ambience of the main S1 and main S2 in the event.

References:

  • v0.0.4 reference: xenon:xenonnt:ac:prediction:shadow_ambience

Columns provided

Field name Data type Comment
s1_n_lh_before int16 Number of lh before main S1
s2_n_lh_before int16 Number of lh before main S2
s1_n_s0_before int16 Number of s0 before main S1
s2_n_s0_before int16 Number of s0 before main S2
s1_n_s1_before int16 Number of s1 before main S1
s2_n_s1_before int16 Number of s1 before main S2
s1_n_s2_before int16 Number of s2 before main S1
s2_n_s2_before int16 Number of s2 before main S2
s1_n_s2_near int16 Number of s2 near main S1
s2_n_s2_near int16 Number of s2 near main S2
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_ambience event_ambience event_basics event_basics event_ambience->event_basics peak_basics peak_basics event_ambience->peak_basics peak_ambience peak_ambience event_ambience->peak_ambience event_basics->peak_basics events events event_basics->events peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaks peaks peak_basics->peaks peak_ambience->peak_basics peak_ambience->peak_positions lone_hits lone_hits peak_ambience->lone_hits events->peak_basics events->peak_proximity peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

event_area_per_channel

Description

Provided by plugin: EventAreaPerChannel

Data kind: events

Simple plugin that provides area per channel for main and alternative S1/S2 in the event.

Columns provided

Field name Data type Comment
s1_area_per_channel ('<f4', (494,)) Area per channel for main S1
s1_length int32 Length of the interval in samples for main S1
s1_dt int32 Width of one sample for main S1 [ns]
s2_area_per_channel ('<f4', (494,)) Area per channel for main S2
s2_length int32 Length of the interval in samples for main S2
s2_dt int32 Width of one sample for main S2 [ns]
alt_s1_area_per_channel ('<f4', (494,)) Area per channel for alternative S1
alt_s1_length int32 Length of the interval in samples for alternative S1
alt_s1_dt int32 Width of one sample for alternative S1 [ns]
alt_s2_area_per_channel ('<f4', (494,)) Area per channel for alternative S2
alt_s2_length int32 Length of the interval in samples for alternative S2
alt_s2_dt int32 Width of one sample for alternative S2 [ns]
s1_n_channels int16 Main S1 count of contributing PMTs
s1_top_n_channels int16 Main S1 top count of contributing PMTs
s1_bottom_n_channels int16 Main S1 bottom count of contributing PMTs
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_area_per_channel event_area_per_channel event_basics event_basics event_area_per_channel->event_basics peaks peaks event_area_per_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
n_top_pmts 253 253 Number of top PMTs

event_n_channel

Description

Provided by plugin: EventAreaPerChannel

Data kind: events

Simple plugin that provides area per channel for main and alternative S1/S2 in the event.

Columns provided

Field name Data type Comment
s1_n_channels int16 Main S1 count of contributing PMTs
s1_top_n_channels int16 Main S1 top count of contributing PMTs
s1_bottom_n_channels int16 Main S1 bottom count of contributing PMTs
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_n_channel event_n_channel event_basics event_basics event_n_channel->event_basics peaks peaks event_n_channel->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
n_top_pmts 253 253 Number of top PMTs

event_nearest_triggering

Description

Provided by plugin: EventNearestTriggering

Data kind: events

Time difference and properties of the nearest triggering peaks of main peaks of events.

Columns provided

Field name Data type Comment
s1_left_dtime int64 time difference of the nearest triggering peak on the left of main S1 [ns]
s1_left_time int64 time of the nearest triggering peak on the left of main S1 [ns]
s1_left_endtime int64 endtime of the nearest triggering peak on the left of main S1 [ns]
s1_left_center_time int64 center_time of the nearest triggering peak on the left of main S1 [ns]
s1_left_type int8 type of the nearest triggering peak on the left of main S1
s1_left_n_competing int32 n_competing of the nearest triggering peak on the left of main S1
s1_left_area float32 area of the nearest triggering peak on the left of main S1 [PE]
s1_right_dtime int64 time difference of the nearest triggering peak on the right of main S1 [ns]
s1_right_time int64 time of the nearest triggering peak on the right of main S1 [ns]
s1_right_endtime int64 endtime of the nearest triggering peak on the right of main S1 [ns]
s1_right_center_time int64 center_time of the nearest triggering peak on the right of main S1 [ns]
s1_right_type int8 type of the nearest triggering peak on the right of main S1
s1_right_n_competing int32 n_competing of the nearest triggering peak on the right of main S1
s1_right_area float32 area of the nearest triggering peak on the right of main S1 [PE]
s2_left_dtime int64 time difference of the nearest triggering peak on the left of main S2 [ns]
s2_left_time int64 time of the nearest triggering peak on the left of main S2 [ns]
s2_left_endtime int64 endtime of the nearest triggering peak on the left of main S2 [ns]
s2_left_center_time int64 center_time of the nearest triggering peak on the left of main S2 [ns]
s2_left_type int8 type of the nearest triggering peak on the left of main S2
s2_left_n_competing int32 n_competing of the nearest triggering peak on the left of main S2
s2_left_area float32 area of the nearest triggering peak on the left of main S2 [PE]
s2_right_dtime int64 time difference of the nearest triggering peak on the right of main S2 [ns]
s2_right_time int64 time of the nearest triggering peak on the right of main S2 [ns]
s2_right_endtime int64 endtime of the nearest triggering peak on the right of main S2 [ns]
s2_right_center_time int64 center_time of the nearest triggering peak on the right of main S2 [ns]
s2_right_type int8 type of the nearest triggering peak on the right of main S2
s2_right_n_competing int32 n_competing of the nearest triggering peak on the right of main S2
s2_right_area float32 area of the nearest triggering peak on the right of main S2 [PE]
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_nearest_triggering event_nearest_triggering event_basics event_basics event_nearest_triggering->event_basics peak_basics peak_basics event_nearest_triggering->peak_basics peak_nearest_triggering peak_nearest_triggering event_nearest_triggering->peak_nearest_triggering event_basics->peak_basics events events event_basics->events peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaks peaks peak_basics->peaks peak_nearest_triggering->peak_basics peak_nearest_triggering->peak_proximity events->peak_basics events->peak_proximity peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

event_shadow

Description

Provided by plugin: EventShadow

Data kind: events

This plugin can calculate shadow for main S1 and main S2 in events. It also gives the

position information of the previous peaks.

References:

  • v0.1.4 reference: xenon:xenonnt:ac:prediction:shadow_ambience

Columns provided

Field name Data type Comment
s1_shadow_s1_time_shadow float32 largest time shadow casting from previous s1 to main S1 [PE/ns]
s1_dt_s1_time_shadow int64 time difference from the previous s1 casting largest time shadow to main S1 [ns]
s1_nearest_dt_s1 int64 time difference from the nearest previous large s1 to main S1 [ns]
s1_shadow_s2_time_shadow float32 largest time shadow casting from previous s2 to main S1 [PE/ns]
s1_dt_s2_time_shadow int64 time difference from the previous s2 casting largest time shadow to main S1 [ns]
s1_x_s2_time_shadow float32 x of previous s2 peak casting largest time shadow on main S1 [cm]
s1_y_s2_time_shadow float32 y of previous s2 peak casting largest time shadow on main S1 [cm]
s1_nearest_dt_s2 int64 time difference from the nearest previous large s2 to main S1 [ns]
s1_shadow_s2_position_shadow float32 largest position shadow casting from previous s2 to main S1 [PE/ns]
s1_dt_s2_position_shadow int64 time difference from the previous s2 casting largest position shadow to main S1 [ns]
s1_x_s2_position_shadow float32 x of previous s2 peak casting largest position shadow on main S1 [cm]
s1_y_s2_position_shadow float32 y of previous s2 peak casting largest position shadow on main S1 [cm]
s1_pdf_s2_position_shadow float32 PDF describing correlation between previous s2 and main S1
s2_shadow_s1_time_shadow float32 largest time shadow casting from previous s1 to main S2 [PE/ns]
s2_dt_s1_time_shadow int64 time difference from the previous s1 casting largest time shadow to main S2 [ns]
s2_nearest_dt_s1 int64 time difference from the nearest previous large s1 to main S2 [ns]
s2_shadow_s2_time_shadow float32 largest time shadow casting from previous s2 to main S2 [PE/ns]
s2_dt_s2_time_shadow int64 time difference from the previous s2 casting largest time shadow to main S2 [ns]
s2_x_s2_time_shadow float32 x of previous s2 peak casting largest time shadow on main S2 [cm]
s2_y_s2_time_shadow float32 y of previous s2 peak casting largest time shadow on main S2 [cm]
s2_nearest_dt_s2 int64 time difference from the nearest previous large s2 to main S2 [ns]
s2_shadow_s2_position_shadow float32 largest position shadow casting from previous s2 to main S2 [PE/ns]
s2_dt_s2_position_shadow int64 time difference from the previous s2 casting largest position shadow to main S2 [ns]
s2_x_s2_position_shadow float32 x of previous s2 peak casting largest position shadow on main S2 [cm]
s2_y_s2_position_shadow float32 y of previous s2 peak casting largest position shadow on main S2 [cm]
s2_pdf_s2_position_shadow float32 PDF describing correlation between previous s2 and main S2
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_shadow event_shadow event_basics event_basics event_shadow->event_basics peak_basics peak_basics event_shadow->peak_basics peak_shadow peak_shadow event_shadow->peak_shadow event_basics->peak_basics events events event_basics->events peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaks peaks peak_basics->peaks peak_shadow->peak_basics peak_shadow->peak_positions events->peak_basics events->peak_proximity peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

event_w_bayes_class

Description

Provided by plugin: EventwBayesClass

Data kind: events

Append at event level the posterior probability for an S1, S2, alt_S1 and alt_S2.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
s1_ln_prob_s1 float32 Given an s1, s1 ln probability
s1_ln_prob_s2 float32 Given an s1, s2 ln probability
s2_ln_prob_s1 float32 Given an s2, s1 ln probability
s2_ln_prob_s2 float32 Given an s2, s2 ln probability
alt_s1_ln_prob_s1 float32 Given an alt_s1, s1 ln probability
alt_s1_ln_prob_s2 float32 Given an alt_s1, s2 ln probability
alt_s2_ln_prob_s1 float32 Given an alt_s2, s1 ln probability
alt_s2_ln_prob_s2 float32 Given an alt_s2, s2 ln probability

Dependencies

%3 event_w_bayes_class event_w_bayes_class peak_classification_bayes peak_classification_bayes event_w_bayes_class->peak_classification_bayes event_basics event_basics event_w_bayes_class->event_basics peaks peaks peak_classification_bayes->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

gps_sync

Description

Provided by plugin: GpsSync

Data kind: events

Correct the event times to GPS time.

1. Finds the TTL GPS pulses coming into the AM from the gps module and their pairs coming from the module for the correspondent run.

  1. Corrects the timestamp of all events by linearly interpolating

between the previous and next sync pulses.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
t_gps int64 GPS absolute time [ns]

Dependencies

%3 gps_sync gps_sync aqmon_hits aqmon_hits gps_sync->aqmon_hits event_basics event_basics gps_sync->event_basics raw_records_aqmon raw_records_aqmon aqmon_hits->raw_records_aqmon events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
gps_truth_vicinity 4.5 <OMITTED> +/- time interval in [s] in which the GPS truth should be searched for each GPS pulse.
tpc_internal_delay {'0': 4917, '020380': 10137, '043040': 0} <OMITTED> Internal delay between aqmon and regular TPC channels ins [ns]

peak_corrections

Description

Provided by plugin: PeakCorrectedAreas

Data kind: peaks

Pluging to apply corrections on peak level assuming that the main S1 is the only physical

S1.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
cs2_wo_elifecorr float32 Corrected area of S2 before elife correction (s2 xy correction + SEG/EE correction applied) [PE]
cs2_wo_timecorr float32 Corrected area of S2 before SEG/EE and elife corrections (s2 xy correction applied) [PE]
cs2_area_fraction_top float32 Fraction of area seen by the top PMT array for corrected S2
cs2_bottom float32 Corrected area of S2 in the bottom PMT array [PE]
cs2 float32 Corrected area of S2 [PE]
s1_xyz_correction_factor float32 Correction factor for the S1 area based on S2 position
s1_rel_light_yield_correction_factor float32 Relative light yield correction factor for the S1 area
z_obs_ms float32 z position of the multiscatter peak

Dependencies

%3 peak_corrections peak_corrections peak_basics peak_basics peak_corrections->peak_basics peak_positions peak_positions peak_corrections->peak_positions peak_per_event peak_per_event peak_corrections->peak_per_event peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_per_event->peak_basics peak_per_event->peak_positions event_basics event_basics peak_per_event->event_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks event_basics->peak_basics event_basics->peak_positions events events event_basics->events peak_proximity peak_proximity event_basics->peak_proximity events->peak_basics events->peak_proximity peak_proximity->peak_basics

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
avg_se_gain cmt://avg_...gin.run_id <OMITTED> Nominal single electron (SE) gain in PE / electron extracted. Data will be corrected to this value
cs2_bottom_top_ratio_correction 1 <OMITTED> Scaling factor for cS2 AFT correction due to photon ionization
default_reconstruction_algorithm mlp <OMITTED> default reconstruction algorithm that provides (x,y)
electron_drift_time_gate cmt://elec...gin.run_id <OMITTED> Electron drift time from the gate in ns
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
elife cmt://elif...gin.run_id <OMITTED> electron lifetime in [ns]
region_circular 60 <OMITTED> circular cut (cm) for ab region, check out the note https://xe1t-wiki.lngs.infn.it/doku.php?id=jlong:sr0_2_region_se_correction
region_linear 28 <OMITTED> linear cut (cm) for ab region, check out the note https://xe1t-wiki.lngs.infn.it/doku.php?id=jlong:sr0_2_region_se_correction
rel_extraction_eff cmt://rel_...gin.run_id <OMITTED> Relative extraction efficiency for this run (allows for time dependence)
rel_light_yield cmt://rela...gin.run_id <OMITTED> Relative light yield (allows for time dependence)
s1_xyz_map itp_map://..._algorithm <OMITTED>
s2_xy_map itp_map://..._algorithm <OMITTED>
se_gain cmt://se_g...gin.run_id <OMITTED> Actual SE gain for a given run (allows for time dependence)

distinct_channels

Description

Provided by plugin: DistinctChannels

Data kind: events

Compute the number of contributing PMTs that contribute to the alt_s1 but not to the main

S1.

Columns provided

Field name Data type Comment
alt_s1_distinct_channels int32 Number of PMTs contributing to the secondary S1 that do not contribute to the main S1
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 distinct_channels distinct_channels event_basics event_basics distinct_channels->event_basics peaks peaks distinct_channels->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

peak_per_event

Description

Provided by plugin: EventPeaks

Data kind: peaks

Add event number for peaks and drift times of all s2 depending on the largest s1.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
drift_time float32 Drift time between main S1 and S2 in ns
event_number int64 Event number in this dataset

Dependencies

%3 peak_per_event peak_per_event event_basics event_basics peak_per_event->event_basics peak_basics peak_basics peak_per_event->peak_basics peak_positions peak_positions peak_per_event->peak_positions event_basics->peak_basics event_basics->peak_positions events events event_basics->events peak_proximity peak_proximity event_basics->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn events->peak_basics events->peak_proximity peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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

event_positions

Description

Provided by plugin: EventPositions

Data kind: events

Computes the observed and corrected position for the main S1/S2 pairs in an event.

For XENONnT data, it returns the FDC corrected positions of the default_reconstruction_algorithm. In case the fdc_map is given as a file (not through CMT), then the coordinate system should be given as (x, y, z), not (x, y, drift_time).

Columns provided

Field name Data type Comment
x float32 Main interaction x-position, field-distortion corrected (cm)
alt_s1_x_fdc float32 Alternative S1 interaction (rel. main S2) x-position, field-distortion corrected (cm)
alt_s2_x_fdc float32 Alternative S2 interaction (rel. main S1) x-position, field-distortion corrected (cm)
y float32 Main interaction y-position, field-distortion corrected (cm)
alt_s1_y_fdc float32 Alternative S1 interaction (rel. main S2) y-position, field-distortion corrected (cm)
alt_s2_y_fdc float32 Alternative S2 interaction (rel. main S1) y-position, field-distortion corrected (cm)
r float32 Main interaction r-position, field-distortion corrected (cm)
alt_s1_r_fdc float32 Alternative S1 interaction (rel. main S2) r-position, field-distortion corrected (cm)
alt_s2_r_fdc float32 Alternative S2 interaction (rel. main S1) r-position, field-distortion corrected (cm)
z float32 Interaction z-position, corrected to non-uniform drift velocity (cm)
z_dv_corr float32 Interaction z-position, corrected to non-uniform drift velocity, duplicated (cm)
alt_s1_z float32 Alternative S1 z-position (rel. main S2), corrected to non-uniform drift velocity (cm)
alt_s1_z_dv_corr float32 Alternative S1 z-position (rel. main S2), corrected to non-uniform drift velocity, duplicated (cm)
alt_s2_z float32 Alternative S2 z-position (rel. main S1), corrected to non-uniform drift velocity (cm)
alt_s2_z_dv_corr float32 Alternative S2 z-position (rel. main S1), corrected to non-uniform drift velocity, duplicated (cm)
r_naive float32 Main interaction r-position with observed position (cm)
alt_s1_r_naive float32 Alternative S1 interaction (rel. main S2) r-position with observed position (cm)
alt_s2_r_naive float32 Alternative S2 interaction (rel. main S1) r-position with observed position (cm)
z_naive float32 Main interaction z-position with observed position (cm)
alt_s1_z_naive float32 Alternative S1 interaction (rel. main S2) z-position with observed position (cm)
alt_s2_z_naive float32 Alternative S2 interaction (rel. main S1) z-position with observed position (cm)
r_field_distortion_correction float32 Correction added to r_naive for field distortion (cm)
alt_s1_r_field_distortion_correction float32 Correction added to alt_s1_r_naive for field distortion (cm)
alt_s2_r_field_distortion_correction float32 Correction added to alt_s2_r_naive for field distortion (cm)
z_field_distortion_correction float32 Correction added to z_naive for field distortion (cm)
alt_s1_z_field_distortion_correction float32 Correction added to alt_s1_z_naive for field distortion (cm)
alt_s2_z_field_distortion_correction float32 Correction added to alt_s2_z_naive for field distortion (cm)
alt_s1_theta float32 Alternative S1 (rel. main S2) interaction angular position (radians)
alt_s2_theta float32 Alternative S2 (rel. main S1) interaction angular position (radians)
theta float32 Main interaction angular position (radians)
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_positions event_positions event_basics event_basics event_positions->event_basics events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
default_reconstruction_algorithm mlp <OMITTED> default reconstruction algorithm that provides (x,y)
electron_drift_time_gate cmt://elec...gin.run_id <OMITTED> Electron drift time from the gate in ns
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
fdc_map legacy-fdc...gin.run_id itp_map://resource://cmt://format://fdc_map_{alg}?alg=plugin.default_reconstruction_algorithm&version=ONLINE&run_id=plugin.run_id&fmt=binary&scale_coordinates=plugin.coordinate_scales 3D field distortion correction map path
z_bias_map legacy-z_bias://0 itp_map://resource://XnT_z_bias_map_chargeup_20230329.json.gz?fmt=json.gz&method=RegularGridInterpolator Map of Z bias due to non uniform drift velocity/field

event_waveform

Description

Provided by plugin: EventWaveform

Data kind: events

Simple plugin that provides total (data) and top (data_top) waveforms for main and

alternative S1/S2 in the event.

Columns provided

Field name Data type Comment
s1_data ('<f4', (200,)) Waveform for main S1 [ PE / sample ]
s1_data_top ('<f4', (200,)) Top waveform for main S1 [ PE / sample ]
s1_length int32 Length of the interval in samples for main S1
s1_dt int32 Width of one sample for main S1 [ns]
s2_data ('<f4', (200,)) Waveform for main S2 [ PE / sample ]
s2_data_top ('<f4', (200,)) Top waveform for main S2 [ PE / sample ]
s2_length int32 Length of the interval in samples for main S2
s2_dt int32 Width of one sample for main S2 [ns]
alt_s1_data ('<f4', (200,)) Waveform for alternative S1 [ PE / sample ]
alt_s1_data_top ('<f4', (200,)) Top waveform for alternative S1 [ PE / sample ]
alt_s1_length int32 Length of the interval in samples for alternative S1
alt_s1_dt int32 Width of one sample for alternative S1 [ns]
alt_s2_data ('<f4', (200,)) Waveform for alternative S2 [ PE / sample ]
alt_s2_data_top ('<f4', (200,)) Top waveform for alternative S2 [ PE / sample ]
alt_s2_length int32 Length of the interval in samples for alternative S2
alt_s2_dt int32 Width of one sample for alternative S2 [ns]
s1_n_channels int16 Main S1 count of contributing PMTs
s1_top_n_channels int16 Main S1 top count of contributing PMTs
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_waveform event_waveform event_basics event_basics event_waveform->event_basics peaks peaks event_waveform->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
n_top_pmts 253 253 Number of top PMTs

event_local_min_info

Description

Provided by plugin: LocalMinimumInfo

Data kind: events

Looks for the main S2 peak in an event, finds the local minimum (if there is one), and looks

to compute some figures of merit such as the max goodness of split, width of the valley, and height of the valley.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
s2_max_gos float32 Maximum Goodness of Split
s2_num_loc_max int16 Number of local maxima of the smoothed peak
s2_valley_gap float32 Full gap at p% of the valley height of the deepest valley [ns],by default p = 90
s2_valley_height_ratio float32 Valley depth over max height of the deepest valley

Dependencies

%3 event_local_min_info event_local_min_info event_basics event_basics event_local_min_info->event_basics peaks peaks event_local_min_info->peaks events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
divide_90p_width_localmin 7.0 <OMITTED> The peak is smoothed by dividing the 90p width bythis number, and coverting it into number of samples.This is then the 'n' used in the smoothing kernelshown below.
percent_valley_height 0.9 <OMITTED> The percentage of the valley height of the deepestvalley for which to calculate the valley width
percentage_threshold_localmin 0.1 <OMITTED> The height threshold for the peak as a percentageof the maximum, used to reject the low partsof the peak in order to find the local extrema.
smoothing_power_localmin 3.0 <OMITTED> The power used in the smoothing filter with a kernel of(1-(x/n)^p)^p, where p is the power

s2_recon_pos_diff

Description

Provided by plugin: S2ReconPosDiff

Data kind: events

Plugin that provides position reconstruction difference for S2s in events, see note:

Columns provided

Field name Data type Comment
s2_recon_avg_x float32 Mean value of x for main S2
alt_s2_recon_avg_x float32 Mean value of x for alternatice S2
s2_recon_avg_y float32 Mean value of y for main S2
alt_s2_recon_avg_y float32 Mean value of y for alternatice S2
s2_recon_pos_diff float32 Reconstructed position difference for main S2
alt_s2_recon_pos_diff float32 Reconstructed position difference for alternative S2
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 s2_recon_pos_diff s2_recon_pos_diff event_basics event_basics s2_recon_pos_diff->event_basics events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
recon_alg_included (_mlp, _gcn) <OMITTED> The list of all reconstruction algorithm considered.

event_basics

Description

Provided by plugin: EventBasics

Data kind: events

Computes the basic properties of the main/alternative S1/S2 within an event.

The main S1 and alternative S1 are given by the largest two S1-Peaks within the event. The main S2 is given by the largest S2-Peak within the event, while alternative S2 is selected as the largest S2 other than main S2 in the time window [main S1 time, main S1 time + max drift time].

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_peaks int32 Number of peaks in the event
drift_time float32 Drift time between main S1 and S2 in ns
event_number int64 Event number in this dataset
s1_index int32 Main S1 peak index in event
alt_s1_index int32 Alternate S1 peak index in event
s1_time int64 Main S1 start time since unix epoch [ns]
alt_s1_time int64 Alternate S1 start time since unix epoch [ns]
s1_center_time int64 Main S1 weighted center time since unix epoch [ns]
alt_s1_center_time int64 Alternate S1 weighted center time since unix epoch [ns]
s1_endtime int64 Main S1 end time since unix epoch [ns]
alt_s1_endtime int64 Alternate S1 end time since unix epoch [ns]
s1_area float32 Main S1 area, uncorrected [PE]
alt_s1_area float32 Alternate S1 area, uncorrected [PE]
s1_n_channels int16 Main S1 count of contributing PMTs
alt_s1_n_channels int16 Alternate S1 count of contributing PMTs
s1_n_hits int16 Main S1 count of hits contributing at least one sample to the peak
alt_s1_n_hits int16 Alternate S1 count of hits contributing at least one sample to the peak
s1_n_competing int32 Main S1 number of competing peaks
alt_s1_n_competing int32 Alternate S1 number of competing peaks
s1_max_pmt int16 Main S1 PMT number which contributes the most PE
alt_s1_max_pmt int16 Alternate S1 PMT number which contributes the most PE
s1_max_pmt_area float32 Main S1 area in the largest-contributing PMT (PE)
alt_s1_max_pmt_area float32 Alternate S1 area in the largest-contributing PMT (PE)
s1_range_50p_area float32 Main S1 width, 50% area [ns]
alt_s1_range_50p_area float32 Alternate S1 width, 50% area [ns]
s1_range_90p_area float32 Main S1 width, 90% area [ns]
alt_s1_range_90p_area float32 Alternate S1 width, 90% area [ns]
s1_rise_time float32 Main S1 time between 10% and 50% area quantiles [ns]
alt_s1_rise_time float32 Alternate S1 time between 10% and 50% area quantiles [ns]
s1_area_fraction_top float32 Main S1 fraction of area seen by the top PMT array
alt_s1_area_fraction_top float32 Alternate S1 fraction of area seen by the top PMT array
s1_tight_coincidence int16 Main S1 Channel within tight range of mean
alt_s1_tight_coincidence int16 Alternate S1 Channel within tight range of mean
s1_n_saturated_channels int16 Main S1 Total number of saturated channels
alt_s1_n_saturated_channels int16 Alternate S1 Total number of saturated channels
alt_s1_interaction_drift_time float32 Drift time using alternate S1 [ns]
alt_s1_delay int32 Time between main and alternate S1 [ns]
s2_index int32 Main S2 peak index in event
alt_s2_index int32 Alternate S2 peak index in event
s2_time int64 Main S2 start time since unix epoch [ns]
alt_s2_time int64 Alternate S2 start time since unix epoch [ns]
s2_center_time int64 Main S2 weighted center time since unix epoch [ns]
alt_s2_center_time int64 Alternate S2 weighted center time since unix epoch [ns]
s2_endtime int64 Main S2 end time since unix epoch [ns]
alt_s2_endtime int64 Alternate S2 end time since unix epoch [ns]
s2_area float32 Main S2 area, uncorrected [PE]
alt_s2_area float32 Alternate S2 area, uncorrected [PE]
s2_n_channels int16 Main S2 count of contributing PMTs
alt_s2_n_channels int16 Alternate S2 count of contributing PMTs
s2_n_hits int16 Main S2 count of hits contributing at least one sample to the peak
alt_s2_n_hits int16 Alternate S2 count of hits contributing at least one sample to the peak
s2_n_competing int32 Main S2 number of competing peaks
alt_s2_n_competing int32 Alternate S2 number of competing peaks
s2_max_pmt int16 Main S2 PMT number which contributes the most PE
alt_s2_max_pmt int16 Alternate S2 PMT number which contributes the most PE
s2_max_pmt_area float32 Main S2 area in the largest-contributing PMT (PE)
alt_s2_max_pmt_area float32 Alternate S2 area in the largest-contributing PMT (PE)
s2_range_50p_area float32 Main S2 width, 50% area [ns]
alt_s2_range_50p_area float32 Alternate S2 width, 50% area [ns]
s2_range_90p_area float32 Main S2 width, 90% area [ns]
alt_s2_range_90p_area float32 Alternate S2 width, 90% area [ns]
s2_rise_time float32 Main S2 time between 10% and 50% area quantiles [ns]
alt_s2_rise_time float32 Alternate S2 time between 10% and 50% area quantiles [ns]
s2_area_fraction_top float32 Main S2 fraction of area seen by the top PMT array
alt_s2_area_fraction_top float32 Alternate S2 fraction of area seen by the top PMT array
s2_tight_coincidence int16 Main S2 Channel within tight range of mean
alt_s2_tight_coincidence int16 Alternate S2 Channel within tight range of mean
s2_n_saturated_channels int16 Main S2 Total number of saturated channels
alt_s2_n_saturated_channels int16 Alternate S2 Total number of saturated channels
alt_s2_interaction_drift_time float32 Drift time using alternate S2 [ns]
alt_s2_delay int32 Time between main and alternate S2 [ns]
s1_max_diff int32 Main S1 largest time difference between apexes of hits [ns]
alt_s1_max_diff int32 Alternate S1 largest time difference between apexes of hits [ns]
s1_min_diff int32 Main S1 smallest time difference between apexes of hits [ns]
alt_s1_min_diff int32 Alternate S1 smallest time difference between apexes of hits [ns]
s2_x float32 Main S2 reconstructed X position, uncorrected [cm]
s2_y float32 Main S2 reconstructed Y position, uncorrected [cm]
alt_s2_x float32 Alternate S2 reconstructed X position, uncorrected [cm]
alt_s2_y float32 Alternate S2 reconstructed Y position, uncorrected [cm]
area_before_main_s2 float32 Sum of areas before Main S2 [PE]
large_s2_before_main_s2 float32 The largest S2 before the Main S2 [PE]
s2_x_cnn float32 Main S2 cnn-reconstructed X position, uncorrected [cm]
s2_y_cnn float32 Main S2 cnn-reconstructed Y position, uncorrected [cm]
alt_s2_x_cnn float32 Alternate S2 cnn-reconstructed X position, uncorrected [cm]
alt_s2_y_cnn float32 Alternate S2 cnn-reconstructed Y position, uncorrected [cm]
s2_x_gcn float32 Main S2 gcn-reconstructed X position, uncorrected [cm]
s2_y_gcn float32 Main S2 gcn-reconstructed Y position, uncorrected [cm]
alt_s2_x_gcn float32 Alternate S2 gcn-reconstructed X position, uncorrected [cm]
alt_s2_y_gcn float32 Alternate S2 gcn-reconstructed Y position, uncorrected [cm]
s2_x_mlp float32 Main S2 mlp-reconstructed X position, uncorrected [cm]
s2_y_mlp float32 Main S2 mlp-reconstructed Y position, uncorrected [cm]
alt_s2_x_mlp float32 Alternate S2 mlp-reconstructed X position, uncorrected [cm]
alt_s2_y_mlp float32 Alternate S2 mlp-reconstructed Y position, uncorrected [cm]

Dependencies

%3 event_basics event_basics events events event_basics->events peak_basics peak_basics event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
allow_posts2_s1s False <OMITTED> Allow S1s past the main S2 to become the main S1 and S2
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
event_s1_min_coincidence 2 <OMITTED> Event level S1 min coincidence. Should be >= s1_min_coincidence in the peaklet classification
force_alt_s2_in_max_drift_time True <OMITTED> Make sure alt_s2 is in max drift time starting from main S1
force_main_before_alt False <OMITTED> Make the alternate S1 (and likewise S2) the main S1 if occurs before the main S1.
max_drift_length 148.6515 <OMITTED> Total length of the TPC from the bottom of gate to the top of cathode wires [cm]

peak_ambience

Description

Provided by plugin: PeakAmbience

Data kind: peaks

Calculate Ambience of peaks. Features are the number of lonehits, small S0, S1, S2 in a time

window before peaks, and the number of small S2 in circle near the S2 peak in a time window.

References:

  • v0.0.7 reference: xenon:xenonnt:ac:prediction:shadow_ambience

Columns provided

Field name Data type Comment
n_lh_before int16 Number of small lh before a peak
s_lh_before float32 Area sum of small lh before a peak
n_s0_before int16 Number of small s0 before a peak
s_s0_before float32 Area sum of small s0 before a peak
n_s1_before int16 Number of small s1 before a peak
s_s1_before float32 Area sum of small s1 before a peak
n_s2_before int16 Number of small s2 before a peak
s_s2_before float32 Area sum of small s2 before a peak
n_s2_near int16 Number of small s2 near a peak
s_s2_near float32 Area sum of small s2 near a peak
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_ambience peak_ambience lone_hits lone_hits peak_ambience->lone_hits peak_basics peak_basics peak_ambience->peak_basics peak_positions peak_positions peak_ambience->peak_positions records records lone_hits->records peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn raw_records raw_records records->raw_records peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s peaklets->records peaklet_classification->peaklets merged_s2s->lone_hits merged_s2s->peaklets merged_s2s->peaklet_classification peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
ambience_area_parameters (5, 60, 60) <OMITTED> The upper limit of S0, S1, S2 area to be counted
ambience_divide_r False <OMITTED> Whether to divide area by radial distance of ambience creating peak to current peak
ambience_divide_t False <OMITTED> Whether to divide area by time difference of ambience creating peak to current peak
ambience_time_window_backward 2000000 <OMITTED> Search for ambience in this time window [ns]
ambient_radius 6.7 <OMITTED> Search for ambience in this radius [cm]

peak_shadow

Description

Provided by plugin: PeakShadow

Data kind: peaks

This plugin can find and calculate the time & position shadow from previous peaks in time. It

also gives the area and (x,y) of the previous peaks.

References:

  • v0.1.5 reference: xenon:xenonnt:ac:prediction:shadow_ambience

Columns provided

Field name Data type Comment
shadow_s1_time_shadow float32 previous large s1 casted largest time shadow [PE/ns]
dt_s1_time_shadow int64 time difference to the previous large s1 peak casting largest time shadow [ns]
nearest_dt_s1 int64 time difference to the nearest previous large s1 [ns]
shadow_s2_time_shadow float32 previous large s2 casted largest time shadow [PE/ns]
dt_s2_time_shadow int64 time difference to the previous large s2 peak casting largest time shadow [ns]
x_s2_time_shadow float32 x of previous large s2 peak casting largest time shadow [cm]
y_s2_time_shadow float32 y of previous large s2 peak casting largest time shadow [cm]
nearest_dt_s2 int64 time difference to the nearest previous large s2 [ns]
shadow_s2_position_shadow float32 previous large s2 casted largest position shadow [PE/ns]
dt_s2_position_shadow int64 time difference to the previous large s2 peak casting largest position shadow [ns]
x_s2_position_shadow float32 x of previous large s2 peak casting largest position shadow [cm]
y_s2_position_shadow float32 y of previous large s2 peak casting largest position shadow [cm]
pdf_s2_position_shadow float32 PDF describing correlation to the previous large s2
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_shadow peak_shadow peak_basics peak_basics peak_shadow->peak_basics peak_positions peak_positions peak_shadow->peak_positions peaks peaks peak_basics->peaks peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks

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
shadow_deltatime_exponent -1.0 <OMITTED> The exponent of delta t when calculating shadow
shadow_sigma_and_baseline [15.22, 0.036] <OMITTED> Fitted position correlation sigma[cm*PE^0.5] and baseline[cm] using in position shadow
shadow_threshold {'s1_time_shadow': 1000.0, 's2_time_shadow': 10000.0, 's2_position_shadow': 10000.0} <OMITTED> Only take S1/S2s larger than this into account when calculating Shadow [PE]
shadow_time_window_backward 1000000000 <OMITTED> Search for peaks casting time & position shadow in this time window [ns]

peak_positions

Description

Provided by plugin: PeakPositionsNT

Data kind: peaks

Merge the reconstructed algorithms of the different algorithms into a single one that can be

used in Event Basics.

Select one of the plugins to provide the ‘x’ and ‘y’ to be used further down the chain. Since we already have the information needed here, there is no need to wait until events to make the decision.

Since the computation is trivial as it only combined the three input plugins, don’t save this plugins output.

Columns provided

Field name Data type Comment
x_cnn float32 Reconstructed cnn S2 X position (cm), uncorrected
y_cnn float32 Reconstructed cnn S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
x_mlp float32 Reconstructed mlp S2 X position (cm), uncorrected
y_mlp float32 Reconstructed mlp S2 Y position (cm), uncorrected
x_gcn float32 Reconstructed gcn S2 X position (cm), uncorrected
y_gcn float32 Reconstructed gcn S2 Y position (cm), uncorrected
x float32 Reconstructed S2 X position (cm), uncorrected
y float32 Reconstructed S2 Y position (cm), uncorrected

Dependencies

%3 peak_positions peak_positions peak_positions_cnn peak_positions_cnn peak_positions->peak_positions_cnn peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_gcn peak_positions_gcn peak_positions->peak_positions_gcn peaks peaks peak_positions_cnn->peaks peak_positions_mlp->peaks peak_positions_gcn->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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
default_reconstruction_algorithm mlp <OMITTED> default reconstruction algorithm that provides (x,y)
min_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
min_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
min_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
n_top_pmts 253 253 Number of top PMTs
n_top_pmts 253 253 Number of top PMTs
tf_model_cnn tf://resou...t=abs_path <OMITTED> CNN model. Should be opened using the "tf" descriptor. Set to "None" to skip computation
tf_model_gcn tf://resou...t=abs_path <OMITTED> GCN model. Should be opened using the "tf" descriptor. Set to "None" to skip computation
tf_model_mlp tf://resou...t=abs_path <OMITTED> MLP model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

events

Description

Provided by plugin: Events

Data kind: events

Plugin which defines an “event” in our TPC.

An event is defined by peak(s) in fixed range of time around a peak which satisfies certain conditions:

  1. The triggering peak must have a certain area.

  2. The triggering peak must have less than “trigger_max_competing” peaks. (A competing peak must have a certain area fraction of the triggering peak and must be in a window close to the main peak)

Note:

The time range which defines an event gets chopped at the chunk boundaries. This happens at invalid boundaries of the

Columns provided

Field name Data type Comment
event_number int64 Event number in this dataset
time int64 Event start time in ns since the unix epoch
endtime int64 Event end time in ns since the unix epoch

Dependencies

%3 events events peak_basics peak_basics events->peak_basics peak_proximity peak_proximity events->peak_proximity peaks peaks peak_basics->peaks peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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
diagnose_overlapping True <OMITTED> Enable runtime checks for disjointness
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
event_s1_min_coincidence 2 <OMITTED> Event level S1 min coincidence. Should be >= s1_min_coincidence in the peaklet classification
exclude_s1_as_triggering_peaks True <OMITTED> If true exclude S1s as triggering peaks.
left_event_extension 250000 <OMITTED> Extend events this many ns to the left from each triggering peak. This extension is added to the maximum drift time.
max_drift_length 148.6515 <OMITTED> Total length of the TPC from the bottom of gate to the top of cathode wires [cm]
right_event_extension 250000 <OMITTED> Extend events this many ns to the right from each triggering peak.
s1_min_coincidence 2 <OMITTED> Minimum tight coincidence necessary to make an S1
trigger_max_competing 7 <OMITTED> Peaks must have FEWER nearby larger or slightly smaller peaks to cause events
trigger_min_area 100 <OMITTED> Peaks must have more area (PE) than this to cause events

individual_peak_monitor

Description

Provided by plugin: IndividualPeakMonitor

Data kind: individual_peak_monitor

Plugin to write data needed for the online SE monitor to the online- monitor collection in

the runs-database. Data that is written by this plugin should be small such as to not overload the runs- database. If the peaks are large, random max_bytes of data are selected from the peaks.

This plugin takes ‘peak_basics’ and ‘peak_positions_mlp’. 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 ‘individual_peak_monitor’ with info on the peaks and their positions.

Columns provided

Field name Data type Comment
area float32 Peak integral in PE
x_mlp float32 Reconstructed mlp peak x-position
y_mlp float32 Reconstructed mlp peak y-position
range_50p_area float32 Width (in ns) of the central 50% area of the peak
weight float32 Fraction of original peaks array length that is saved
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 individual_peak_monitor individual_peak_monitor peak_basics peak_basics individual_peak_monitor->peak_basics peak_positions_mlp peak_positions_mlp individual_peak_monitor->peak_positions_mlp peaks peaks peak_basics->peaks peak_positions_mlp->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_max_bytes 6000000.0 <OMITTED> Maximum amount of bytes of data for MongoDB document

peak_nearest_triggering

Description

Provided by plugin: PeakNearestTriggering

Data kind: peaks

Time difference and properties of the nearest triggering peaks in the left and right

direction of peaks.

Columns provided

Field name Data type Comment
left_dtime int64 time difference of the nearest triggering peak on the left [ns]
left_time int64 time of the nearest triggering peak on the left [ns]
left_endtime int64 endtime of the nearest triggering peak on the left [ns]
left_center_time int64 center_time of the nearest triggering peak on the left [ns]
left_type int8 type of the nearest triggering peak on the left
left_n_competing int32 n_competing of the nearest triggering peak on the left
left_area float32 area of the nearest triggering peak on the left [PE]
right_dtime int64 time difference of the nearest triggering peak on the right [ns]
right_time int64 time of the nearest triggering peak on the right [ns]
right_endtime int64 endtime of the nearest triggering peak on the right [ns]
right_center_time int64 center_time of the nearest triggering peak on the right [ns]
right_type int8 type of the nearest triggering peak on the right
right_n_competing int32 n_competing of the nearest triggering peak on the right
right_area float32 area of the nearest triggering peak on the right [PE]
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_nearest_triggering peak_nearest_triggering peak_basics peak_basics peak_nearest_triggering->peak_basics peak_proximity peak_proximity peak_nearest_triggering->peak_proximity peaks peaks peak_basics->peaks peak_proximity->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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
diagnose_overlapping True <OMITTED> Enable runtime checks for disjointness
electron_drift_velocity cmt://elec...gin.run_id <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
event_s1_min_coincidence 2 <OMITTED> Event level S1 min coincidence. Should be >= s1_min_coincidence in the peaklet classification
exclude_s1_as_triggering_peaks True <OMITTED> If true exclude S1s as triggering peaks.
left_event_extension 250000 <OMITTED> Extend events this many ns to the left from each triggering peak. This extension is added to the maximum drift time.
max_drift_length 148.6515 <OMITTED> Total length of the TPC from the bottom of gate to the top of cathode wires [cm]
only_trigger_min_area False <OMITTED> Whether only require the triggering peak to have area larger than trigger_min_area
right_event_extension 250000 <OMITTED> Extend events this many ns to the right from each triggering peak.
s1_min_coincidence 2 <OMITTED> Minimum tight coincidence necessary to make an S1
shadow_time_window_backward 1000000000 <OMITTED> Search for peaks casting time & position shadow in this time window [ns]
trigger_max_competing 7 <OMITTED> Peaks must have FEWER nearby larger or slightly smaller peaks to cause events
trigger_min_area 100 <OMITTED> Peaks must have more area (PE) than this to cause events

peak_som_classification

Description

Provided by plugin: PeaksSOMClassification

Data kind: peaks

Plugin which propagates S1 SOM infromation to peaks if straxen.PeakClassification is still

used.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
som_sub_type int32 SOM subtype of the peak(let)
som_type int8 SOM type of the peak(let)
loc_x_som int16 x location of the peak(let) in the SOM
loc_y_som int16 y location of the peak(let) in the SOM

Dependencies

%3 peak_som_classification peak_som_classification peak_basics peak_basics peak_som_classification->peak_basics peaklet_classification_som peaklet_classification_som peak_som_classification->peaklet_classification_som peaks peaks peak_basics->peaks peaklets peaklets peaklet_classification_som->peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_peak_monitor

Description

Provided by plugin: OnlinePeakMonitor

Data kind: online_peak_monitor

Plugin to write data to the online-monitor. Data that is written by this plugin should be

small such as to not overload the runs- database.

This plugin takes ‘peak_basics’ and ‘lone_hits’. 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_peak_monitor’ with info on the lone-hits and peaks

Columns provided

Field name Data type Comment
time int64 Start time of the chunk
endtime int64 End time of the chunk
area_vs_width_hist ('<i8', (60, 60)) Area vs width histogram (log-log)
area_vs_width_bounds ('<f8', (2, 2)) Area vs width edges (log-space)
lone_hits_area_hist ('<i8', (100,)) Lone hits areas histogram [ADC-counts]
lone_hits_area_bounds ('<f8', (2,)) Lone hits areas bounds [ADC-counts]
lone_hits_per_channel ('<i8', (494,)) Lone hits per channel
aft_hist ('<i8', (100,)) AFT histogram
aft_bounds ('<f8', (2,)) AFT bounds
n_channel_hist ('<i8', (494,)) Number of contributing channels histogram
online_se_gain float32 Single electron gain

Dependencies

%3 online_peak_monitor online_peak_monitor peak_basics peak_basics online_peak_monitor->peak_basics lone_hits lone_hits online_peak_monitor->lone_hits peaks peaks peak_basics->peaks records records lone_hits->records peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s peaklets->records peaklet_classification->peaklets merged_s2s->lone_hits merged_s2s->peaklets merged_s2s->peaklet_classification raw_records raw_records records->raw_records

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
area_vs_width_bounds ((0, 5), (0, 5)) <OMITTED> Boundaries of log-log histogram of area vs width
area_vs_width_cut_string <OMITTED> Selection (like selection_str) applied to data for "area_vs_width_hist_clean", cuts should be separated using "&"For example: (tight_coincidence > 2) & (area_fraction_top < 0.1)Default is no selection (other than "area_vs_width_min_gap")
area_vs_width_nbins 60 <OMITTED> Number of bins for area vs width histogram for online monitor. NB: this is a 2D histogram
lone_hits_area_bounds (0, 1500) <OMITTED> Boundaries area histogram of lone hits [ADC]
lone_hits_cut_string (area >= 50) & (area <= 250) <OMITTED> Selection (like selection_str) applied to data for "lone-hits", cuts should be separated using "&")
lone_hits_min_gap 15000 <OMITTED> Minimal gap [ns] between consecutive lone-hits. To turn off this cut, set to 0.
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
online_peak_monitor_nbins 100 <OMITTED> Number of bins of histogram of online monitor. Will be used for: lone_hits_area-histogram, area_fraction_top-histogram, online_se_gain estimate (histogram is not stored),
online_se_bounds (7, 70) <OMITTED> Window for online monitor [PE] to look for the SE gain, value

peak_proximity

Description

Provided by plugin: PeakProximity

Data kind: peaks

Look for peaks around a peak to determine how many peaks are in proximity (in time) of a

peak.

Columns provided

Field name Data type Comment
n_competing int32 Number of nearby larger or slightly smaller peaks
n_competing_left int32 Number of larger or slightly smaller peaks left of the main peak
t_to_prev_peak int64 Time between end of previous peak and start of this peak [ns]
t_to_next_peak int64 Time between end of this peak and start of next peak [ns]
t_to_nearest_peak int64 Smaller of t_to_prev_peak and t_to_next_peak [ns]
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_proximity peak_proximity peak_basics peak_basics peak_proximity->peak_basics peaks peaks peak_basics->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_area_fraction 0.5 <OMITTED> The area of competing peaks must be at least this fraction of that of the considered peak
nearby_window 10000000.0 <OMITTED> Peaks starting within this time window (on either side) in ns count as nearby.
peak_max_proximity_time 100000000.0 <OMITTED> Maximum value for proximity values such as t_to_next_peak [ns]

peak_top_bottom_params

Description

Provided by plugin: PeakTopBottomParams

Data kind: peaks

Pluging that computes timing characteristics of top and bottom waveforms based on waveforms

stored at peak level.

Columns provided

Field name Data type Comment
center_time_top int64 Central time for top PMTs [ ns ]
rise_time_top float32 Time between 10% and 50% area quantiles for top PMTs [ns]
range_50p_area_top float32 Width (in ns) of the central 50% area of the peak for top PMTs
range_90p_area_top float32 Width (in ns) of the central 90% area of the peak for top PMTs
center_time_bot int64 Central time for bot PMTs [ ns ]
rise_time_bot float32 Time between 10% and 50% area quantiles for bot PMTs [ns]
range_50p_area_bot float32 Width (in ns) of the central 50% area of the peak for bot PMTs
range_90p_area_bot float32 Width (in ns) of the central 90% area of the peak for bot PMTs
center_time_diff_top_bot int64 Difference between center times of top and bottom arrays [ ns ]
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_top_bottom_params peak_top_bottom_params peaks peaks peak_top_bottom_params->peaks peak_basics peak_basics peak_top_bottom_params->peak_basics peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s peak_basics->peaks records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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

peak_classification_bayes

Description

Provided by plugin: BayesPeakClassification

Data kind: peaks

Bayes Peak classification Returns the ln probability of a each event belonging to the S1 and

S2 class. Uses conditional probabilities and data parameterization learned from wfsim data. More info can be found here xenon:xenonnt:ahiguera:bayespeakclassification.

param peaks:

peaks

param waveforms:

peaks waveforms in PE/ns

param quantiles:

quantiles in ns, calculate from a cumulative sum over the waveform, from zero to the total area with normalized cumulative sum to determine the time

return:

the ln probability of a each peak belonging to S1 and S2 class

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
ln_prob_s1 float32 S1 ln probability
ln_prob_s2 float32 S2 ln probability

Dependencies

%3 peak_classification_bayes peak_classification_bayes peaks peaks peak_classification_bayes->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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
bayes_config_file resource:/...id&fmt=npy <OMITTED> Bayes model, conditional probabilities tables and Bayes discrete bins
bayes_n_nodes 50 <OMITTED> Number of attributes(features) per waveform and quantile
n_bayes_classes 2 <OMITTED> Number of label classes S1(1)/S2(2)

peak_basics

Description

Provided by plugin: PeakBasics

Data kind: peaks

Compute the basic peak-properties, thereby dropping structured arrays.

NB: This plugin can therefore be loaded as a pandas DataFrame.

Columns provided

Field name Data type Comment
time int64 Start time of the peak (ns since unix epoch)
endtime int64 End time of the peak (ns since unix epoch)
center_time int64 Weighted center time of the peak (ns since unix epoch)
area float32 Peak integral in PE
n_hits int32 Number of hits contributing at least one sample to the peak
n_channels int16 Number of PMTs contributing to the peak
max_pmt int16 PMT number which contributes the most PE
max_pmt_area float32 Area of signal in the largest-contributing PMT (PE)
n_saturated_channels int16 Total number of saturated channels
range_50p_area float32 Width (in ns) of the central 50% area of the peak
range_90p_area float32 Width (in ns) of the central 90% area of the peak
area_fraction_top float32 Fraction of area seen by the top array (NaN for peaks with non-positive area)
length int32 Length of the peak waveform in samples
dt int16 Time resolution of the peak waveform in ns
rise_time float32 Time between 10% and 50% area quantiles [ns]
tight_coincidence int16 Number of PMTs with hits within tight range of mean
type int8 Classification of the peak(let)
max_diff int32 Largest time difference between apexes of hits inside peak [ns]
min_diff int32 Smallest time difference between apexes of hits inside peak [ns]

Dependencies

%3 peak_basics peak_basics peaks peaks peak_basics->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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
check_peak_sum_area_rtol NaN <OMITTED> Check if the sum area and the sum of area per channel are the same. If None, don't do the check. To perform the check, set to the desired rtol value used e.g. '1e-4' (see np.isclose).
n_top_pmts 253.0 253 Number of top PMTs

peak_positions_cnn

Description

Provided by plugin: PeakPositionsCNN

Data kind: peaks

Convolutional Neural Network (CNN) neural net for position reconstruction.

Columns provided

Field name Data type Comment
x_cnn float32 Reconstructed cnn S2 X position (cm), uncorrected
y_cnn float32 Reconstructed cnn S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_positions_cnn peak_positions_cnn peaks peaks peak_positions_cnn->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_model_cnn tf://resou...t=abs_path <OMITTED> CNN model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

peak_positions_gcn

Description

Provided by plugin: PeakPositionsGCN

Data kind: peaks

Graph Convolutional Network (GCN) neural net for position reconstruction.

Columns provided

Field name Data type Comment
x_gcn float32 Reconstructed gcn S2 X position (cm), uncorrected
y_gcn float32 Reconstructed gcn S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_positions_gcn peak_positions_gcn peaks peaks peak_positions_gcn->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_model_gcn tf://resou...t=abs_path <OMITTED> GCN model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

peak_positions_mlp

Description

Provided by plugin: PeakPositionsMLP

Data kind: peaks

Multilayer Perceptron (MLP) neural net for position reconstruction.

Columns provided

Field name Data type Comment
x_mlp float32 Reconstructed mlp S2 X position (cm), uncorrected
y_mlp float32 Reconstructed mlp S2 Y position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_positions_mlp peak_positions_mlp peaks peaks peak_positions_mlp->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_reconstruction_area 10 <OMITTED> Skip reconstruction if area (PE) is less than this
n_top_pmts 253 253 Number of top PMTs
tf_model_mlp tf://resou...t=abs_path <OMITTED> MLP model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

peak_s1_positions_cnn

Description

Provided by plugin: PeakS1PositionCNN

Data kind: peaks

S1 CNN for (x,y,z) position S1 reconstruction at peak level.

Columns provided

Field name Data type Comment
x_s1_cnn float32 Reconstructed s1_cnn S1 X position (cm), uncorrected
y_s1_cnn float32 Reconstructed s1_cnn S1 Y position (cm), uncorrected
z_s1_cnn float32 Reconstructed s1_cnn S1 Z position (cm), uncorrected
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_s1_positions_cnn peak_s1_positions_cnn peaks peaks peak_s1_positions_cnn->peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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_s1_area_s1_posrec 1000 <OMITTED> Skip reconstruction if area (PE) is less than this
tf_model_s1_cnn tf://resou...attr=value <OMITTED> s1 position 3d reconstruction cnn model. Should be opened using the "tf" descriptor. Set to "None" to skip computation

peaks

Description

Provided by plugin: Peaks

Data kind: peaks

Merge peaklets and merged S2s such that we obtain our peaks (replacing all peaklets that were

later re-merged as S2s).

As this step is computationally trivial, never save this plugin.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
length int32 Length of the interval in samples
dt int32 Width of one sample [ns]
channel int16 Channel/PMT number
type int8 Classification of the peak(let)
area float32 Integral across channels [PE]
area_per_channel ('<f4', (494,)) Integral per channel [PE]
n_hits int32 Number of hits contributing at least one sample to the peak
data ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!)
data_top ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), top array
width ('<f4', (11,)) Peak widths in range of central area fraction [ns]
area_decile_from_midpoint ('<f4', (11,)) Peak widths: time between nth and 5th area decile [ns]
saturated_channel ('i1', (494,)) Does the channel reach ADC saturation?
n_saturated_channels int16 Total number of saturated channels
tight_coincidence int16 Channel within tight range of mean
max_gap int32 Largest gap between hits inside peak [ns]
max_goodness_of_split float32 Maximum interior goodness of split
max_diff int32 Largest time difference between apexes of hits inside peak [ns]
min_diff int32 Smallest time difference between apexes of hits inside peak [ns]

Dependencies

%3 peaks peaks peaklets peaklets peaks->peaklets peaklet_classification peaklet_classification peaks->peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records peaklet_classification->peaklets merged_s2s->peaklets merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits raw_records raw_records records->raw_records lone_hits->records

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
diagnose_sorting False <OMITTED> Enable runtime checks for sorting and disjointness
merge_without_s1 True <OMITTED> If true, S1s will be igored during the merging. It's now possible for a S1 to be inside a S2 post merging

merged_s2s

Description

Provided by plugin: MergedS2s

Data kind: merged_s2s

Merge together peaklets if peak finding favours that they would form a single peak

instead.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
length int32 Length of the interval in samples
dt int32 Width of one sample [ns]
channel int16 Channel/PMT number
type int8 Classification of the peak(let)
area float32 Integral across channels [PE]
area_per_channel ('<f4', (494,)) Integral per channel [PE]
n_hits int32 Number of hits contributing at least one sample to the peak
data ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!)
data_top ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), top array
width ('<f4', (11,)) Peak widths in range of central area fraction [ns]
area_decile_from_midpoint ('<f4', (11,)) Peak widths: time between nth and 5th area decile [ns]
saturated_channel ('i1', (494,)) Does the channel reach ADC saturation?
n_saturated_channels int16 Total number of saturated channels
tight_coincidence int16 Channel within tight range of mean
max_gap int32 Largest gap between hits inside peak [ns]
max_goodness_of_split float32 Maximum interior goodness of split
max_diff int32 Largest time difference between apexes of hits inside peak [ns]
min_diff int32 Smallest time difference between apexes of hits inside peak [ns]

Dependencies

%3 merged_s2s merged_s2s peaklets peaklets merged_s2s->peaklets peaklet_classification peaklet_classification merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits records records peaklets->records peaklet_classification->peaklets lone_hits->records raw_records raw_records records->raw_records

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
gain_model <OMITTED> cmt://to_pe_model?version=ONLINE&run_id=plugin.run_id PMT gain model. Specify as (str(model_config), str(version), nT-->boolean
merge_without_s1 True <OMITTED> If true, S1s will be igored during the merging. It's now possible for a S1 to be inside a S2 post merging
merged_s2s_get_window_size_factor 5 <OMITTED> Factor of the window size for the merged_s2s plugin
n_top_pmts <OMITTED> 253 Number of top TPC array PMTs
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
s2_merge_gap_thresholds ((1.7, 26500.0), (4.0, 2600.0), (5.0, 0.0)) <OMITTED> Points to define maximum separation between peaklets to allow merging [ns] depending on log10 area of the merged peak\nwhere the gap size of the first point is the maximum gap to allow mergingand the area of the last point is the maximum area to allow merging. The format is ((log10(area), max_gap), (..., ...), (..., ...))
s2_merge_max_duration 50000 <OMITTED> Do not merge peaklets at all if the result would be a peak longer than this [ns]
sum_waveform_top_array True <OMITTED> Digitize the sum waveform of the top array separately

peaklet_classification

Description

Provided by plugin: PeakletClassification

Data kind: peaklets

Classify peaklets as unknown, S1, or S2.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
length int32 Length of the interval in samples
dt int32 Width of one sample [ns]
channel int16 Channel/PMT number
type int8 Classification of the peak(let)

Dependencies

%3 peaklet_classification peaklet_classification peaklets peaklets peaklet_classification->peaklets records records peaklets->records raw_records raw_records records->raw_records

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
n_top_pmts 253 253 Number of top PMTs
s1_flatten_threshold_aft (0.6, 100) <OMITTED> Threshold for AFT, above which we use a flatted boundary for rise timeSpecified values: (AFT boundary, constant rise time).
s1_max_rise_time_post100 200 <OMITTED> Maximum S1 rise time for > 100 PE [ns]
s1_min_coincidence 2 <OMITTED> Minimum tight coincidence necessary to make an S1
s1_risetime_aft_parameters (-1, 2.6) <OMITTED> Slope and offset in exponential of emperical boundary in the rise time-AFT plot. Specified as (slope, offset)
s1_risetime_area_parameters (50, 80, 12) <OMITTED> norm, const, tau in the empirical boundary in the risetime-area plot
s2_min_pmts 4 <OMITTED> Minimum number of PMTs contributing to an S2

peaklet_classification_som

Description

Provided by plugin: PeakletSOMClass

Data kind: peaklets

Plugin which allows in addition to the straxen classification the SOM classification.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
length int32 Length of the interval in samples
dt int32 Width of one sample [ns]
channel int16 Channel/PMT number
type int8 Classification of the peak(let)
som_sub_type int32 SOM subtype of the peak(let)
straxen_type int8 Old straxen type of the peak(let)
som_type int8 SOM type of the peak(let)
loc_x_som int16 x location of the peak(let) in the SOM
loc_y_som int16 y location of the peak(let) in the SOM

Dependencies

%3 peaklet_classification_som peaklet_classification_som peaklets peaklets peaklet_classification_som->peaklets records records peaklets->records raw_records raw_records records->raw_records

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
n_top_pmts 253 253 Number of top PMTs
s1_flatten_threshold_aft (0.6, 100) <OMITTED> Threshold for AFT, above which we use a flatted boundary for rise timeSpecified values: (AFT boundary, constant rise time).
s1_max_rise_time_post100 200 <OMITTED> Maximum S1 rise time for > 100 PE [ns]
s1_min_coincidence 2 <OMITTED> Minimum tight coincidence necessary to make an S1
s1_risetime_aft_parameters (-1, 2.6) <OMITTED> Slope and offset in exponential of emperical boundary in the rise time-AFT plot. Specified as (slope, offset)
s1_risetime_area_parameters (50, 80, 12) <OMITTED> norm, const, tau in the empirical boundary in the risetime-area plot
s2_min_pmts 4 <OMITTED> Minimum number of PMTs contributing to an S2
som_files resource:/...00&fmt=npy <OMITTED>
use_som_as_default True <OMITTED> Boolean to indicate whether to use SOM or the straxen classifcation method forpeaklet classification

peaklets

Description

Provided by plugin: Peaklets

Data kind: peaklets

Split records into:

  • peaklets

  • lone_hits

Peaklets are very aggressively split peaks such that we are able to find S1-S2s even if they are close to each other. (S2) Peaks that are split into too many peaklets will be merged later on.

To get Peaklets from records apply/do:

  1. Hit finding

  2. Peak finding

  3. Peak splitting using the natural breaks algorithm

  4. Compute the digital sum waveform

Lone hits are all hits which are outside of any peak. The area of lone_hits includes the left and right hit extension, except the extension overlaps with any peaks or other hits.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
length int32 Length of the interval in samples
dt int32 Width of one sample [ns]
channel int16 Channel/PMT number
type int8 Classification of the peak(let)
area float32 Integral across channels [PE]
area_per_channel ('<f4', (494,)) Integral per channel [PE]
n_hits int32 Number of hits contributing at least one sample to the peak
data ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!)
data_top ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), top array
width ('<f4', (11,)) Peak widths in range of central area fraction [ns]
area_decile_from_midpoint ('<f4', (11,)) Peak widths: time between nth and 5th area decile [ns]
saturated_channel ('i1', (494,)) Does the channel reach ADC saturation?
n_saturated_channels int16 Total number of saturated channels
tight_coincidence int16 Channel within tight range of mean
max_gap int32 Largest gap between hits inside peak [ns]
max_goodness_of_split float32 Maximum interior goodness of split
max_diff int32 Largest time difference between apexes of hits inside peak [ns]
min_diff int32 Smallest time difference between apexes of hits inside peak [ns]

Dependencies

%3 peaklets peaklets records records peaklets->records raw_records raw_records records->raw_records

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.
diagnose_sorting False <OMITTED> Enable runtime checks for sorting and disjointness
gain_model <OMITTED> cmt://to_pe_model?version=ONLINE&run_id=plugin.run_id PMT gain model. Specify as URL or explicit value
hit_min_amplitude cmt://hit_...gin.run_id <OMITTED> Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
n_top_pmts <OMITTED> 253 Number of top TPC array PMTs
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
peak_left_extension 30 <OMITTED> Include this many ns left of hits in peaks
peak_min_pmts 2 <OMITTED> Minimum number of contributing PMTs needed to define a peak
peak_right_extension 200 <OMITTED> Include this many ns right of hits in peaks
peak_split_filter_wing_width 70 <OMITTED> Wing width of moving average filter for low-split natural breaks
peak_split_gof_threshold (None, ((0.5, 1.0), (6.0, 0.4)), ((2.5, 1.0), (5.625, 0.4))) <OMITTED> Natural breaks goodness of fit/split threshold to split a peak. Specify as tuples of (log10(area), threshold).
peak_split_iterations 20 <OMITTED> Maximum number of recursive peak splits to do.
peak_split_min_area 40.0 <OMITTED> Minimum area to evaluate natural breaks criterion. Smaller peaks are not split.
peaklet_gap_threshold 700 <OMITTED> No hits for this many ns triggers a new peak
peaklet_max_duration 10000000 <OMITTED> Maximum duration [ns] of a peaklet
saturation_correction_on True <OMITTED> On off switch for saturation correction
saturation_min_reference_length 20 <OMITTED> Minimum number of reference sample used to correct saturated samples
saturation_reference_length 100 <OMITTED> Maximum number of reference sample used to correct saturated samples
sum_waveform_top_array True <OMITTED> Digitize the sum waveform of the top array separately
tight_coincidence_window_left 50 <OMITTED> Time range left of peak center to call a hit a tight coincidence (ns)
tight_coincidence_window_right 50 <OMITTED> Time range right of peak center to call a hit a tight coincidence (ns)

lone_hits

Description

Provided by plugin: Peaklets

Data kind: lone_hits

Split records into:

  • peaklets

  • lone_hits

Peaklets are very aggressively split peaks such that we are able to find S1-S2s even if they are close to each other. (S2) Peaks that are split into too many peaklets will be merged later on.

To get Peaklets from records apply/do:

  1. Hit finding

  2. Peak finding

  3. Peak splitting using the natural breaks algorithm

  4. Compute the digital sum waveform

Lone hits are all hits which are outside of any peak. The area of lone_hits includes the left and right hit extension, except the extension overlaps with any peaks or other hits.

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 Integral [ADC x samples]
left int16 Index of sample in record in which hit starts
right int16 Index of first sample in record just beyond hit (exclusive bound)
left_integration int16 For lone hits, index of sample in record where integration starts
right_integration int16 For lone hits, index of first sample beyond integration region
record_i int32 Internal (temporary) index of fragment in which hit was found
threshold float32 ADC threshold applied in order to find hits
height float32 Maximum amplitude above baseline [ADC counts]

Dependencies

%3 lone_hits lone_hits records records lone_hits->records raw_records raw_records records->raw_records

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.
diagnose_sorting False <OMITTED> Enable runtime checks for sorting and disjointness
gain_model <OMITTED> cmt://to_pe_model?version=ONLINE&run_id=plugin.run_id PMT gain model. Specify as URL or explicit value
hit_min_amplitude cmt://hit_...gin.run_id <OMITTED> Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
n_top_pmts <OMITTED> 253 Number of top TPC array PMTs
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
peak_left_extension 30 <OMITTED> Include this many ns left of hits in peaks
peak_min_pmts 2 <OMITTED> Minimum number of contributing PMTs needed to define a peak
peak_right_extension 200 <OMITTED> Include this many ns right of hits in peaks
peak_split_filter_wing_width 70 <OMITTED> Wing width of moving average filter for low-split natural breaks
peak_split_gof_threshold (None, ((0.5, 1.0), (6.0, 0.4)), ((2.5, 1.0), (5.625, 0.4))) <OMITTED> Natural breaks goodness of fit/split threshold to split a peak. Specify as tuples of (log10(area), threshold).
peak_split_iterations 20 <OMITTED> Maximum number of recursive peak splits to do.
peak_split_min_area 40.0 <OMITTED> Minimum area to evaluate natural breaks criterion. Smaller peaks are not split.
peaklet_gap_threshold 700 <OMITTED> No hits for this many ns triggers a new peak
peaklet_max_duration 10000000 <OMITTED> Maximum duration [ns] of a peaklet
saturation_correction_on True <OMITTED> On off switch for saturation correction
saturation_min_reference_length 20 <OMITTED> Minimum number of reference sample used to correct saturated samples
saturation_reference_length 100 <OMITTED> Maximum number of reference sample used to correct saturated samples
sum_waveform_top_array True <OMITTED> Digitize the sum waveform of the top array separately
tight_coincidence_window_left 50 <OMITTED> Time range left of peak center to call a hit a tight coincidence (ns)
tight_coincidence_window_right 50 <OMITTED> Time range right of peak center to call a hit a tight coincidence (ns)

veto_intervals_gps_sync

Description

Provided by plugin: GpsSyncDAQVeto

Data kind: veto_intervals

Plugin which computes veto_intervals using GPS times.

Required to compute correctly total lifetime loss of experiment.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
t_gps int64 GPS absolute time [ns]

Dependencies

%3 veto_intervals_gps_sync veto_intervals_gps_sync aqmon_hits aqmon_hits veto_intervals_gps_sync->aqmon_hits veto_intervals veto_intervals veto_intervals_gps_sync->veto_intervals raw_records_aqmon raw_records_aqmon aqmon_hits->raw_records_aqmon veto_intervals->aqmon_hits

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
gps_truth_vicinity 4.5 <OMITTED> +/- time interval in [s] in which the GPS truth should be searched for each GPS pulse.
tpc_internal_delay {'0': 4917, '020380': 10137, '043040': 0} <OMITTED> Internal delay between aqmon and regular TPC channels ins [ns]

records

Description

Provided by plugin: PulseProcessing

Data kind: records

Split raw_records into:

  • (tpc) records

  • aqmon_records

  • pulse_counts

For TPC records, apply basic processing:

  1. Flip, baseline, and integrate the waveform

  2. Apply software HE veto after high-energy peaks.

  3. Find hits, apply linear filter, and zero outside hits.

pulse_counts holds some average information for the individual PMT channels for each chunk of raw_records. This includes e.g. number of recorded pulses, lone_pulses (pulses which do not overlap with any other pulse), or mean values of baseline and baseline rms channel.

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 records raw_records raw_records records->raw_records

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
allow_sloppy_chunking False <OMITTED> Use a default baseline for incorrectly chunked fragments. This is a kludge for improperly converted XENON1T data.
baseline_samples 40 <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
hev_gain_model None <OMITTED> PMT gain model used in the software high-energy veto.
hit_min_amplitude cmt://hit_...gin.run_id <OMITTED> Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor 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.
max_veto_value None <OMITTED> Optionally pass a HE peak that exceeds this absolute area. (if performing a hard veto, can keep a few statistics.)
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
pmt_pulse_filter None <OMITTED> Linear filter to apply to pulses, will be normalized.
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 (3, 20) <OMITTED> Save (left, right) samples besides hits; cut the rest
tail_veto_duration 3000000 <OMITTED> Time in ns to veto after large peaks
tail_veto_pass_extend 3 <OMITTED> Extend pass veto by this many samples (tail_veto_resolution!)
tail_veto_pass_fraction 0.05 <OMITTED> Pass veto if maximum amplitude above max * fraction
tail_veto_resolution 1000 <OMITTED> Time resolution in ns for pass-veto waveform summation
tail_veto_threshold 0 <OMITTED> Minimum peakarea in PE to trigger tail veto.Set to None, 0 or False to disable veto.

veto_regions

Description

Provided by plugin: PulseProcessing

Data kind: veto_regions

Split raw_records into:

  • (tpc) records

  • aqmon_records

  • pulse_counts

For TPC records, apply basic processing:

  1. Flip, baseline, and integrate the waveform

  2. Apply software HE veto after high-energy peaks.

  3. Find hits, apply linear filter, and zero outside hits.

pulse_counts holds some average information for the individual PMT channels for each chunk of raw_records. This includes e.g. number of recorded pulses, lone_pulses (pulses which do not overlap with any other pulse), or mean values of baseline and baseline rms channel.

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 Integral [ADC x samples]
left int16 Index of sample in record in which hit starts
right int16 Index of first sample in record just beyond hit (exclusive bound)
left_integration int16 For lone hits, index of sample in record where integration starts
right_integration int16 For lone hits, index of first sample beyond integration region
record_i int32 Internal (temporary) index of fragment in which hit was found
threshold float32 ADC threshold applied in order to find hits
height float32 Maximum amplitude above baseline [ADC counts]

Dependencies

%3 veto_regions veto_regions raw_records raw_records veto_regions->raw_records

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
allow_sloppy_chunking False <OMITTED> Use a default baseline for incorrectly chunked fragments. This is a kludge for improperly converted XENON1T data.
baseline_samples 40 <OMITTED> Number of samples to use at the start of the pulse to determine the baseline
check_raw_record_overlaps True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
hev_gain_model None <OMITTED> PMT gain model used in the software high-energy veto.
hit_min_amplitude cmt://hit_...gin.run_id <OMITTED> Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
max_veto_value None <OMITTED> Optionally pass a HE peak that exceeds this absolute area. (if performing a hard veto, can keep a few statistics.)
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
pmt_pulse_filter None <OMITTED> Linear filter to apply to pulses, will be normalized.
save_outside_hits (3, 20) <OMITTED> Save (left, right) samples besides hits; cut the rest
tail_veto_duration 3000000 <OMITTED> Time in ns to veto after large peaks
tail_veto_pass_extend 3 <OMITTED> Extend pass veto by this many samples (tail_veto_resolution!)
tail_veto_pass_fraction 0.05 <OMITTED> Pass veto if maximum amplitude above max * fraction
tail_veto_resolution 1000 <OMITTED> Time resolution in ns for pass-veto waveform summation
tail_veto_threshold 0 <OMITTED> Minimum peakarea in PE to trigger tail veto.Set to None, 0 or False to disable veto.

pulse_counts

Description

Provided by plugin: PulseProcessing

Data kind: pulse_counts

Split raw_records into:

  • (tpc) records

  • aqmon_records

  • pulse_counts

For TPC records, apply basic processing:

  1. Flip, baseline, and integrate the waveform

  2. Apply software HE veto after high-energy peaks.

  3. Find hits, apply linear filter, and zero outside hits.

pulse_counts holds some average information for the individual PMT channels for each chunk of raw_records. This includes e.g. number of recorded pulses, lone_pulses (pulses which do not overlap with any other pulse), or mean values of baseline and baseline rms channel.

Columns provided

Field name Data type Comment
time int64 Start time of the chunk
endtime int64 End time of the chunk
pulse_count ('<i8', (494,)) Number of pulses
lone_pulse_count ('<i8', (494,)) Number of lone pulses
pulse_area ('<i8', (494,)) Integral of all pulses in ADC_count x samples
lone_pulse_area ('<i8', (494,)) Integral of lone pulses in ADC_count x samples
baseline_mean ('<i2', (494,)) Average baseline
baseline_rms_mean ('<f4', (494,)) Average baseline rms

Dependencies

%3 pulse_counts pulse_counts raw_records raw_records pulse_counts->raw_records

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
allow_sloppy_chunking False <OMITTED> Use a default baseline for incorrectly chunked fragments. This is a kludge for improperly converted XENON1T data.
baseline_samples 40 <OMITTED> Number of samples to use at the start of the pulse to determine the baseline
check_raw_record_overlaps True <OMITTED> Crash if any of the pulses in raw_records overlap with others in the same channel
hev_gain_model None <OMITTED> PMT gain model used in the software high-energy veto.
hit_min_amplitude cmt://hit_...gin.run_id <OMITTED> Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
max_veto_value None <OMITTED> Optionally pass a HE peak that exceeds this absolute area. (if performing a hard veto, can keep a few statistics.)
n_tpc_pmts <OMITTED> 494 Number of TPC PMTs
pmt_pulse_filter None <OMITTED> Linear filter to apply to pulses, will be normalized.
save_outside_hits (3, 20) <OMITTED> Save (left, right) samples besides hits; cut the rest
tail_veto_duration 3000000 <OMITTED> Time in ns to veto after large peaks
tail_veto_pass_extend 3 <OMITTED> Extend pass veto by this many samples (tail_veto_resolution!)
tail_veto_pass_fraction 0.05 <OMITTED> Pass veto if maximum amplitude above max * fraction
tail_veto_resolution 1000 <OMITTED> Time resolution in ns for pass-veto waveform summation
tail_veto_threshold 0 <OMITTED> Minimum peakarea in PE to trigger tail veto.Set to None, 0 or False to disable veto.

veto_intervals

Description

Provided by plugin: VetoIntervals

Data kind: veto_intervals

Find pairs of veto start and veto stop signals and the veto.

duration between them:

  • busy_* <= V1495 busy veto for tpc channels

  • busy_he_* <= V1495 busy veto for high energy tpc channels

  • hev_* <= DDC10 hardware high energy veto

  • straxen_deadtime <= special case of deadtime introduced by the DAQReader-plugin

Columns provided

Field name Data type Comment
veto_interval int64 veto interval [ns]
veto_type <U30 veto signal type
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 veto_intervals veto_intervals aqmon_hits aqmon_hits veto_intervals->aqmon_hits raw_records_aqmon raw_records_aqmon aqmon_hits->raw_records_aqmon

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
max_veto_window 7200000000000 <OMITTED> Maximum separation between veto stop and start pulses [ns]. Set to be >> than the max duration of the run to be able to fully store one run into buffer since aqmon-hits are not sorted by endtime

aqmon_hits

Description

Provided by plugin: AqmonHits

Data kind: aqmon_hits

Find hits in acquisition monitor data.

These hits could be then used by other plugins for deadtime calculations, GPS SYNC analysis, etc.

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 Integral [ADC x samples]
left int16 Index of sample in record in which hit starts
right int16 Index of first sample in record just beyond hit (exclusive bound)
left_integration int16 For lone hits, index of sample in record where integration starts
right_integration int16 For lone hits, index of first sample beyond integration region
record_i int32 Internal (temporary) index of fragment in which hit was found
threshold float32 ADC threshold applied in order to find hits
height float32 Maximum amplitude above baseline [ADC counts]

Dependencies

%3 aqmon_hits aqmon_hits raw_records_aqmon raw_records_aqmon aqmon_hits->raw_records_aqmon

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_aqmon 10 <OMITTED> Number of samples to use at the start of the pulse to determine the baseline
check_raw_record_aqmon_overlaps True <OMITTED> Crash if any of the pulses in raw_records_aqmon overlap with others in the same channel
hit_min_amplitude_aqmon ((50, (800,)), (1500, (797, 798, 801, 802, 803, 804, 805, 806, 807)), (0, (799,))) <OMITTED> Minimum hit threshold in ADC*counts above baseline. Specified per channel in the format (threshold, (chx,chy),)

afterpulses

Description

Provided by plugin: LEDAfterpulseProcessing

Data kind: afterpulses

(no plugin description)

Columns provided

Field name Data type Comment
channel int16 Channel/PMT number
dt int16 Time resolution in ns
time int64 Start time of the interval (ns since unix epoch)
length int32 Length of the interval in samples
area int32 Integral in ADC x samples
area_pe float32 Pulse area in PE
left int16 Sample index in which hit starts
sample_10pc_area int16 Sample index in which hit area succeeds 10% of total area
sample_50pc_area int16 Sample index in which hit area succeeds 50% of total area
max int16 Sample index of hit maximum
right int16 Index of first sample in record just beyond hit (exclusive bound)
height int32 Height of hit in ADC counts
height_pe float32 Height of hit in PE
tdelay int16 Delay of hit w.r.t. LED hit in same WF, in samples
record_i int32 Internal (temporary) index of fragment in which hit was found
left_integration int16 Index of sample in record where integration starts
right_integration int16 Index of first sample beyond integration region
threshold float32 ADC threshold applied in order to find hits

Dependencies

%3 afterpulses afterpulses raw_records raw_records afterpulses->raw_records

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
LED_window_left 50 <OMITTED> Left boundary of sample range for LED pulse integration
LED_window_right 100 <OMITTED> Right boundary of sample range for LED pulse integration
baseline_samples 40 <OMITTED> Number of samples to use at start of WF to determine the baseline
gain_model <OMITTED> cmt://to_pe_model?version=ONLINE&run_id=plugin.run_id PMT gain model. Specify as (model_type, model_config)
hit_min_amplitude cmt://hit_...gin.run_id <OMITTED> Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "legacy-thresholds://pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor url string like "cmt://hit_thresholds_tpc?version=ONLINE" which meanscalling cmt.
hit_min_height_over_noise 4 <OMITTED> Minimum hit amplitude in numbers of baseline_rms above baseline.Actual threshold used is max(hit_min_amplitude, hit_min_height_over_noise * baseline_rms).
n_tpc_pmts <OMITTED> 494 Number of PMTs in TPC
save_outside_hits (3, 20) <OMITTED> Save (left, right) samples besides hits; cut the rest

led_calibration

Description

Provided by plugin: LEDCalibration

Data kind: led_cal

Preliminary version, several parameters to set during commissioning. LEDCalibration returns: channel, time, dt, length, Area, amplitudeLED and amplitudeNOISE.

The new variables are:

  • Area: Area computed in the given window, averaged over 6 windows that have the same starting sample and different end samples.

  • amplitudeLED: peak amplitude of the LED on run in the given window.

  • amplitudeNOISE: amplitude of the LED on run in a window far from the signal one.

Columns provided

Field name Data type Comment
area float32 Area averaged in integration windows
amplitude_led float32 Amplitude in LED window
amplitude_noise float32 Amplitude in off LED window
channel int16 Channel
time int64 Start time of the interval (ns since unix epoch)
dt int16 Time resolution in ns
length int32 Length of the interval in samples

Dependencies

%3 led_calibration led_calibration raw_records raw_records led_calibration->raw_records

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_window (0, 40) <OMITTED> Window (samples) for baseline calculation.
channel_list (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, ...) <OMITTED> List of PMTs. Defalt value: all the PMTs
led_window (78, 132) <OMITTED> Window (samples) where we expect the signal in LED calibration
noise_window (10, 48) <OMITTED> Window (samples) to analysis the noise

raw_records

Description

Provided by plugin: DAQReader

Data kind: raw_records

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 raw_records

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.

raw_records_aqmon

Description

Provided by plugin: DAQReader

Data kind: raw_records_aqmon

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 raw_records_aqmon

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.