Straxen datastructure

This page is an autogenerated reference for all the plugins in straxen’s xenonnt 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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp 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 peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 xedocs://e...ion=ONLINE <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 (without rel LY evolution correction) [PE]
cs1_wo_xyzcorr float32 Corrected area of main S1 (without xyz position correction) [PE]
cs1_wo_peakbiascorr float32 Corrected area of main S1 (without peak bias correction) [PE]
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
cs2_w_bias float32 Corrected area of main S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife)
cs2_w_bias_xy float32 Corrected area of main S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife)
cs2_w_bias_segee float32 Corrected area of main S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_segee float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife)
cs2_w_bias_xy_segee float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife)
cs2_w_bias_xy_elife float32 Corrected area of main S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield)
cs2_w_elife float32 Corrected area of main S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield)
cs2_w_xy_elife float32 Corrected area of main S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_xy_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield)
cs2_w_xy_segee_pi_elife float32 Corrected area of main S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield) [PE]
cs2_area_fraction_top_w_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield)
cs2_w_bias_segee_pi_elife float32 Corrected area of main S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield)
cs2_w_bias_xy_pi_elife float32 Corrected area of main S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield)
cs2_w_bias_xy_segee_elife float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_segee_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield)
cs2_w_bias_xy_segee_pi float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife)
cs2_w_bias_xy_segee_pi_elife float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield)
cs2_w_bias_xy_segee_pi_relcy float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi_relcy float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife)
cs1_b float32 Corrected area of alternate S1 [PE]
cs1_b_wo_timecorr float32 Corrected area of alternate S1 (without rel LY evolution correction) [PE]
alt_cs1_wo_xyzcorr float32 Corrected area of alternate S1 (without xyz position correction) [PE]
alt_cs1_wo_peakbiascorr float32 Corrected area of alternate S1 (without peak bias correction) [PE]
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
alt_cs2_w_bias float32 Corrected area of alternate S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy float32 Corrected area of alternate S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife)
alt_cs2_w_bias_segee float32 Corrected area of alternate S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_segee float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy_segee float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield)
alt_cs2_w_elife float32 Corrected area of alternate S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield)
alt_cs2_w_xy_elife float32 Corrected area of alternate S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_xy_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield)
alt_cs2_w_xy_segee_pi_elife float32 Corrected area of alternate S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield)
alt_cs2_w_bias_segee_pi_elife float32 Corrected area of alternate S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield)
alt_cs2_w_bias_xy_pi_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield)
alt_cs2_w_bias_xy_segee_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield)
alt_cs2_w_bias_xy_segee_pi float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife)
alt_cs2_w_bias_xy_segee_pi_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield)
alt_cs2_w_bias_xy_segee_pi_relcy float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi_relcy float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife)
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 average center time since unix epoch [ns]
s1_b_center_time int64 Alternate S1 weighted average center time since unix epoch [ns]
s1_a_median_time float32 Main S1 weighted relative median time of the peak [ns]
s1_b_median_time float32 Alternate S1 weighted relative median time of the peak [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_top_n_channels int16 Main S1 count of contributing top PMTs
s1_b_top_n_channels int16 Alternate S1 count of contributing top PMTs
s1_a_n_hits int32 Main S1 count of hits contributing at least one sample to the peak
s1_b_n_hits int32 Alternate S1 count of hits contributing at least one sample to the peak
s1_a_proximity_score float32 Main S1 proximity score in (time, space)
s1_b_proximity_score float32 Alternate S1 proximity score in (time, space)
s1_a_n_competing_left int32 Main S1 number of competing peaks left of the main peak
s1_b_n_competing_left int32 Alternate S1 number of competing peaks left of the main 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_a_merged bool Main S1 is merged from peaklets
s1_b_merged bool Alternate S1 is merged from peaklets
s1_a_vanilla_type int8 Main S1 Vanilla type of the peak(let)
s1_b_vanilla_type int8 Alternate S1 Vanilla type of the peak(let)
s1_a_som_type int8 Main S1 SOM type of the peak(let)
s1_b_som_type int8 Alternate S1 SOM type of the peak(let)
s1_a_som_sub_type int32 Main S1 SOM subtype of the peak(let)
s1_b_som_sub_type int32 Alternate S1 SOM subtype of the peak(let)
s1_a_loc_x_som int16 Main S1 x location of the peak(let) in the SOM
s1_b_loc_x_som int16 Alternate S1 x location of the peak(let) in the SOM
s1_a_loc_y_som int16 Main S1 y location of the peak(let) in the SOM
s1_b_loc_y_som int16 Alternate S1 y location of the peak(let) in the SOM
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 average center time since unix epoch [ns]
s2_b_center_time int64 Alternate S2 weighted average center time since unix epoch [ns]
s2_a_median_time float32 Main S2 weighted relative median time of the peak [ns]
s2_b_median_time float32 Alternate S2 weighted relative median time of the peak [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_top_n_channels int16 Main S2 count of contributing top PMTs
s2_b_top_n_channels int16 Alternate S2 count of contributing top PMTs
s2_a_n_hits int32 Main S2 count of hits contributing at least one sample to the peak
s2_b_n_hits int32 Alternate S2 count of hits contributing at least one sample to the peak
s2_a_proximity_score float32 Main S2 proximity score in (time, space)
s2_b_proximity_score float32 Alternate S2 proximity score in (time, space)
s2_a_n_competing_left int32 Main S2 number of competing peaks left of the main peak
s2_b_n_competing_left int32 Alternate S2 number of competing peaks left of the main 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_a_merged bool Main S2 is merged from peaklets
s2_b_merged bool Alternate S2 is merged from peaklets
s2_a_vanilla_type int8 Main S2 Vanilla type of the peak(let)
s2_b_vanilla_type int8 Alternate S2 Vanilla type of the peak(let)
s2_a_som_type int8 Main S2 SOM type of the peak(let)
s2_b_som_type int8 Alternate S2 SOM type of the peak(let)
s2_a_som_sub_type int32 Main S2 SOM subtype of the peak(let)
s2_b_som_sub_type int32 Alternate S2 SOM subtype of the peak(let)
s2_a_loc_x_som int16 Main S2 x location of the peak(let) in the SOM
s2_b_loc_x_som int16 Alternate S2 x location of the peak(let) in the SOM
s2_a_loc_y_som int16 Main S2 y location of the peak(let) in the SOM
s2_b_loc_y_som int16 Alternate S2 y location of the peak(let) in the SOM
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]
s1_a_first_channel int16 Main S1 first channel/PMT number (sorted by apexes of hits)
s1_b_first_channel int16 Alternate S1 first channel/PMT number (sorted by apexes of hits)
s1_a_last_channel int16 Main S1 last channel/PMT number (sorted by apexes of hits)
s1_b_last_channel int16 Alternate last channel/PMT number (sorted by apexes of hits)
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_area float32 The largest S2 before the Main S2 [PE]
large_s2_before_main_s2_index int32 Index of the largest S2 before the Main S2
large_s2_before_main_s2_center_time int64 Center time of the largest S2 before the Main S2 [ns]
large_s2_after_main_s2_area float32 The largest S2 after the Main S2 [PE]
large_s2_after_main_s2_index int32 Index of the largest S2 after the Main S2
large_s2_after_main_s2_center_time int64 Center time of the largest S2 after the Main S2 [ns]
s2_a_x_cnf float32 Main S2 cnf-reconstructed X position, uncorrected [cm]
s2_a_y_cnf float32 Main S2 cnf-reconstructed Y position, uncorrected [cm]
s2_b_x_cnf float32 Alternate S2 cnf-reconstructed X position, uncorrected [cm]
s2_b_y_cnf float32 Alternate S2 cnf-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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_position_uncertainty

Description

Provided by plugin: EventPositionUncertainty

Data kind: events

Plugin to calculate position uncertainties for events using the conditional normalising flow

model. For information on the model, see note.

This plugin computes uncertainties in radial (r) and angular (theta) positions for both main and alternative S2 signals. It uses the position contours calculated by a flow-based algorithm to estimate these uncertainties.

The plugin provides: - Naive flow position uncertainties for main and alternative S2 signals - Corrected flow position uncertainties accounting for field distortions

Depends on: - ‘events’: Basic event information - ‘event_info’: Additional event information - ‘event_position_contour’: Position contours for events

Provides: - ‘event_position_uncertainty’: Calculated position uncertainties

Columns provided

Field name Data type Comment
s2_r_position_uncertainty float32 Naive flow position uncertainty in r for main S2
s2_theta_position_uncertainty float32 Naive flow position uncertainty in theta for main S2
alt_s2_r_position_uncertainty float32 Naive flow position uncertainty in r for alternative S2
alt_s2_theta_position_uncertainty float32 Naive flow position uncertainty in theta for alternative S2
r_position_uncertainty float32 Position uncertainty in r (cm)
theta_position_uncertainty float32 Position uncertainty in theta (rad)
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_position_uncertainty event_position_uncertainty event_info event_info event_position_uncertainty->event_info event_positions event_positions event_position_uncertainty->event_positions event_position_contour event_position_contour event_position_uncertainty->event_position_contour event_info->event_positions event_basics event_basics event_info->event_basics corrected_areas corrected_areas event_info->corrected_areas energy_estimates energy_estimates event_info->energy_estimates event_positions->event_basics event_position_contour->event_positions event_position_contour->event_basics peak_basics peak_basics event_position_contour->peak_basics peak_positions_cnf peak_positions_cnf event_position_contour->peak_positions_cnf events events event_basics->events event_basics->peak_basics peak_positions peak_positions event_basics->peak_positions peak_proximity peak_proximity event_basics->peak_proximity corrected_areas->event_positions corrected_areas->event_basics energy_estimates->corrected_areas events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 (without rel LY evolution correction) [PE]
cs1_wo_xyzcorr float32 Corrected area of main S1 (without xyz position correction) [PE]
cs1_wo_peakbiascorr float32 Corrected area of main S1 (without peak bias correction) [PE]
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
cs2_w_bias float32 Corrected area of main S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife)
cs2_w_bias_xy float32 Corrected area of main S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife)
cs2_w_bias_segee float32 Corrected area of main S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_segee float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife)
cs2_w_bias_xy_segee float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife)
cs2_w_bias_xy_elife float32 Corrected area of main S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield)
cs2_w_elife float32 Corrected area of main S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield)
cs2_w_xy_elife float32 Corrected area of main S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_xy_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield)
cs2_w_xy_segee_pi_elife float32 Corrected area of main S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield) [PE]
cs2_area_fraction_top_w_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield)
cs2_w_bias_segee_pi_elife float32 Corrected area of main S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield)
cs2_w_bias_xy_pi_elife float32 Corrected area of main S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield)
cs2_w_bias_xy_segee_elife float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_segee_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield)
cs2_w_bias_xy_segee_pi float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife)
cs2_w_bias_xy_segee_pi_elife float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield)
cs2_w_bias_xy_segee_pi_relcy float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi_relcy float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife)
alt_cs1 float32 Corrected area of alternate S1 [PE]
alt_cs1_wo_timecorr float32 Corrected area of alternate S1 (without rel LY evolution correction) [PE]
alt_cs1_wo_xyzcorr float32 Corrected area of alternate S1 (without xyz position correction) [PE]
alt_cs1_wo_peakbiascorr float32 Corrected area of alternate S1 (without peak bias correction) [PE]
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
alt_cs2_w_bias float32 Corrected area of alternate S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy float32 Corrected area of alternate S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife)
alt_cs2_w_bias_segee float32 Corrected area of alternate S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_segee float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy_segee float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield)
alt_cs2_w_elife float32 Corrected area of alternate S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield)
alt_cs2_w_xy_elife float32 Corrected area of alternate S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_xy_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield)
alt_cs2_w_xy_segee_pi_elife float32 Corrected area of alternate S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield)
alt_cs2_w_bias_segee_pi_elife float32 Corrected area of alternate S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield)
alt_cs2_w_bias_xy_pi_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield)
alt_cs2_w_bias_xy_segee_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield)
alt_cs2_w_bias_xy_segee_pi float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife)
alt_cs2_w_bias_xy_segee_pi_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield)
alt_cs2_w_bias_xy_segee_pi_relcy float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi_relcy float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife)
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 average center time since unix epoch [ns]
alt_s1_center_time int64 Alternate S1 weighted average center time since unix epoch [ns]
s1_median_time float32 Main S1 weighted relative median time of the peak [ns]
alt_s1_median_time float32 Alternate S1 weighted relative median time of the peak [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_top_n_channels int16 Main S1 count of contributing top PMTs
alt_s1_top_n_channels int16 Alternate S1 count of contributing top PMTs
s1_n_hits int32 Main S1 count of hits contributing at least one sample to the peak
alt_s1_n_hits int32 Alternate S1 count of hits contributing at least one sample to the peak
s1_proximity_score float32 Main S1 proximity score in (time, space)
alt_s1_proximity_score float32 Alternate S1 proximity score in (time, space)
s1_n_competing_left int32 Main S1 number of competing peaks left of the main peak
alt_s1_n_competing_left int32 Alternate S1 number of competing peaks left of the main 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
s1_merged bool Main S1 is merged from peaklets
alt_s1_merged bool Alternate S1 is merged from peaklets
s1_vanilla_type int8 Main S1 Vanilla type of the peak(let)
alt_s1_vanilla_type int8 Alternate S1 Vanilla type of the peak(let)
s1_som_type int8 Main S1 SOM type of the peak(let)
alt_s1_som_type int8 Alternate S1 SOM type of the peak(let)
s1_som_sub_type int32 Main S1 SOM subtype of the peak(let)
alt_s1_som_sub_type int32 Alternate S1 SOM subtype of the peak(let)
s1_loc_x_som int16 Main S1 x location of the peak(let) in the SOM
alt_s1_loc_x_som int16 Alternate 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_loc_y_som int16 Alternate S1 y location of the peak(let) in the SOM
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 average center time since unix epoch [ns]
alt_s2_center_time int64 Alternate S2 weighted average center time since unix epoch [ns]
s2_median_time float32 Main S2 weighted relative median time of the peak [ns]
alt_s2_median_time float32 Alternate S2 weighted relative median time of the peak [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_top_n_channels int16 Main S2 count of contributing top PMTs
alt_s2_top_n_channels int16 Alternate S2 count of contributing top PMTs
s2_n_hits int32 Main S2 count of hits contributing at least one sample to the peak
alt_s2_n_hits int32 Alternate S2 count of hits contributing at least one sample to the peak
s2_proximity_score float32 Main S2 proximity score in (time, space)
alt_s2_proximity_score float32 Alternate S2 proximity score in (time, space)
s2_n_competing_left int32 Main S2 number of competing peaks left of the main peak
alt_s2_n_competing_left int32 Alternate S2 number of competing peaks left of the main 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
s2_merged bool Main S2 is merged from peaklets
alt_s2_merged bool Alternate S2 is merged from peaklets
s2_vanilla_type int8 Main S2 Vanilla type of the peak(let)
alt_s2_vanilla_type int8 Alternate S2 Vanilla type of the peak(let)
s2_som_type int8 Main S2 SOM type of the peak(let)
alt_s2_som_type int8 Alternate S2 SOM type of the peak(let)
s2_som_sub_type int32 Main S2 SOM subtype of the peak(let)
alt_s2_som_sub_type int32 Alternate S2 SOM subtype of the peak(let)
s2_loc_x_som int16 Main S2 x location of the peak(let) in the SOM
alt_s2_loc_x_som int16 Alternate S2 x location of the peak(let) in the SOM
s2_loc_y_som int16 Main S2 y location of the peak(let) in the SOM
alt_s2_loc_y_som int16 Alternate S2 y location of the peak(let) in the SOM
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]
s1_first_channel int16 Main S1 first channel/PMT number (sorted by apexes of hits)
alt_s1_first_channel int16 Alternate S1 first channel/PMT number (sorted by apexes of hits)
s1_last_channel int16 Main S1 last channel/PMT number (sorted by apexes of hits)
alt_s1_last_channel int16 Alternate last channel/PMT number (sorted by apexes of hits)
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_area float32 The largest S2 before the Main S2 [PE]
large_s2_before_main_s2_index int32 Index of the largest S2 before the Main S2
large_s2_before_main_s2_center_time int64 Center time of the largest S2 before the Main S2 [ns]
large_s2_after_main_s2_area float32 The largest S2 after the Main S2 [PE]
large_s2_after_main_s2_index int32 Index of the largest S2 after the Main S2
large_s2_after_main_s2_center_time int64 Center time of the largest S2 after the Main S2 [ns]
s2_x_cnf float32 Main S2 cnf-reconstructed X position, uncorrected [cm]
s2_y_cnf float32 Main S2 cnf-reconstructed Y position, uncorrected [cm]
alt_s2_x_cnf float32 Alternate S2 cnf-reconstructed X position, uncorrected [cm]
alt_s2_y_cnf float32 Alternate S2 cnf-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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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.

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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 cnf <OMITTED> default reconstruction algorithm that provides (x,y)
electron_drift_time_gate xedocs://e...ion=ONLINE <OMITTED> Electron drift time from the gate in ns
electron_drift_velocity xedocs://e...ion=ONLINE <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
gain_model <OMITTED> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value 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://...ion=ONLINE <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...ister=True <OMITTED> S2 (x, y) optical data-driven model
store_per_channel False <OMITTED> Store normalized LLH per channel for each peak

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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s 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

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.

N-1 corrections are also provided, where each variable has all corrections applied except for one specific correction. This allows studying the impact of individual corrections.

The following corrections are applied: - Peak reconstruction bias correction (corrects for bias in peak finding algorithm) - S1 xyz correction (light collection efficiency) - S2 xy correction (light collection efficiency) - Time-dependent light yield correction - Single electron gain (SEG) and extraction efficiency (EE) correction (partition,time) - Photoionization correction for S2 bottom - Electron lifetime correction - Time-dependent charge yield correction

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 (without rel LY evolution correction) [PE]
cs1_wo_xyzcorr float32 Corrected area of main S1 (without xyz position correction) [PE]
cs1_wo_peakbiascorr float32 Corrected area of main S1 (without peak bias correction) [PE]
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
cs2_w_bias float32 Corrected area of main S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife)
cs2_w_bias_xy float32 Corrected area of main S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife)
cs2_w_bias_segee float32 Corrected area of main S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_segee float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife)
cs2_w_bias_xy_segee float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife)
cs2_w_bias_xy_elife float32 Corrected area of main S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield)
cs2_w_elife float32 Corrected area of main S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield)
cs2_w_xy_elife float32 Corrected area of main S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_xy_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield)
cs2_w_xy_segee_pi_elife float32 Corrected area of main S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield) [PE]
cs2_area_fraction_top_w_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield)
cs2_w_bias_segee_pi_elife float32 Corrected area of main S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield)
cs2_w_bias_xy_pi_elife float32 Corrected area of main S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield)
cs2_w_bias_xy_segee_elife float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_segee_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield)
cs2_w_bias_xy_segee_pi float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife)
cs2_w_bias_xy_segee_pi_elife float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield)
cs2_w_bias_xy_segee_pi_relcy float32 Corrected area of main S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife) [PE]
cs2_area_fraction_top_w_bias_xy_segee_pi_relcy float32 Fraction of area seen by the top PMT array for corrected main S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife)
alt_cs1 float32 Corrected area of alternate S1 [PE]
alt_cs1_wo_timecorr float32 Corrected area of alternate S1 (without rel LY evolution correction) [PE]
alt_cs1_wo_xyzcorr float32 Corrected area of alternate S1 (without xyz position correction) [PE]
alt_cs1_wo_peakbiascorr float32 Corrected area of alternate S1 (without peak bias correction) [PE]
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
alt_cs2_w_bias float32 Corrected area of alternate S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias, excluding S2 xy + SEG/EE + photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy float32 Corrected area of alternate S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy, excluding SEG/EE + photoionization + relative charge yield + elife)
alt_cs2_w_bias_segee float32 Corrected area of alternate S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_segee float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + SEG/EE, excluding S2 xy + photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy_segee float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE, excluding photoionization + relative charge yield + elife)
alt_cs2_w_bias_xy_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + elife, excluding SEG/EE + photoionization + relative charge yield)
alt_cs2_w_elife float32 Corrected area of alternate S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including elife, excluding peak bias + S2 xy + SEG/EE + photoionization + relative charge yield)
alt_cs2_w_xy_elife float32 Corrected area of alternate S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_xy_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including S2 xy + elife, excluding peak bias + SEG/EE + photoionization + relative charge yield)
alt_cs2_w_xy_segee_pi_elife float32 Corrected area of alternate S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including S2 xy + SEG/EE + photoionization + elife, excluding peak bias + relative charge yield)
alt_cs2_w_bias_segee_pi_elife float32 Corrected area of alternate S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + SEG/EE + photoionization + elife, excluding S2 xy + relative charge yield)
alt_cs2_w_bias_xy_pi_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + photoionization + elife, excluding SEG/EE + relative charge yield)
alt_cs2_w_bias_xy_segee_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + elife, excluding photoionization + relative charge yield)
alt_cs2_w_bias_xy_segee_pi float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization, excluding relative charge yield + elife)
alt_cs2_w_bias_xy_segee_pi_elife float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi_elife float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + elife, excluding relative charge yield)
alt_cs2_w_bias_xy_segee_pi_relcy float32 Corrected area of alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife) [PE]
alt_cs2_area_fraction_top_w_bias_xy_segee_pi_relcy float32 Fraction of area seen by the top PMT array for corrected alternate S2 (including peak bias + S2 xy + SEG/EE + photoionization + relative charge yield, excluding elife)

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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 xedocs://a...attr=value <OMITTED> Nominal single electron (SE) gain in PE / electron extracted. Data will be corrected to this value
b_rel_light_yield 0.0 <OMITTED> b parameter for z-dependent relative light yield correction
check_s2_only_aft True <OMITTED> Whether to check NaN AFT of S2-Only events
cs2_bottom_top_ratio_correction 1 <OMITTED> Scaling factor for cS2 AFT correction due to photoionization
default_reconstruction_algorithm cnf <OMITTED> default reconstruction algorithm that provides (x,y)
elife xedocs://e...ion=ONLINE <OMITTED> electron lifetime in [ns]
rel_charge_yield 1 <OMITTED> Relative charge yield for SR2 only
rel_extraction_eff take://obj...ion=ONLINE <OMITTED> Relative extraction efficiency for this run (allows for time dependence)
rel_light_yield xedocs://r...ion=ONLINE <OMITTED> Relative light yield (allows for time dependence)
s1_bias_map itp_map://...ion=ONLINE <OMITTED> Interpolation map for S1 peak bias correction. Bias is defined as (reconstructed / raw) - 1.So, the bias correction is reconstructed / (1 + bias).
s1_xyz_map xedocs://s...ion=ONLINE <OMITTED>
s2_bias_map itp_map://...ion=ONLINE <OMITTED> Interpolation map for S2 peak bias correction. Bias is defined as (reconstructed / raw) - 1.So, the bias correction is reconstructed / (1 + bias).
s2_xy_map xedocs://s...ion=ONLINE <OMITTED>
se_gain take://obj...ion=ONLINE <OMITTED> Actual SE gain for a given run (allows for time dependence)
single_electron_gain_partition {'linear': 28, 'circular': 60} <OMITTED> Two distinct patterns of evolution of single electron corrections between AB and CD. Distinguish thanks to linear and circular regions
slope_rel_light_yield 0.0 <OMITTED> Slope parameter for z-dependent relative light yield correction

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

  • v0.1.0 reference: xenon:xenonnt:analysis:redefine_n_competing

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
s1_s_before float32 Sum of small hits and peaks before main S1
s2_s_before float32 Sum of small hits and peaks before 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_ambience peak_ambience event_ambience->peak_ambience 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_ambience->peak_basics peak_ambience->peak_positions lone_hits lone_hits peak_ambience->lone_hits events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_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_proximity_score float32 proximity_score of the nearest triggering peak on the left of main S1
s1_left_n_competing_left int32 n_competing_left 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_proximity_score float32 proximity_score of the nearest triggering peak on the right of main S1
s1_right_n_competing_left int32 n_competing_left 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_proximity_score float32 proximity_score of the nearest triggering peak on the left of main S2
s2_left_n_competing_left int32 n_competing_left 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_proximity_score float32 proximity_score of the nearest triggering peak on the right of main S2
s2_right_n_competing_left int32 n_competing_left 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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_position_contour

Description

Provided by plugin: EventPositionContour

Data kind: events

A strax plugin that computes event position contours and applies field distortion corrections

using the conditional normalising flow model. For information on the model, see note.

This plugin calculates position contours for S2 and alternative S2 signals, and applies field distortion corrections to improve the accuracy of position reconstruction.

Attributes:

__version__ (str): Version of the plugin. depends_on (tuple): Input data types required for this plugin. provides (str): Output data type provided by this plugin. compressor (str): Compression algorithm used for data storage. data_kind (str): Kind of data this plugin processes.

Configuration options:

n_poly (int): Number of points in the uncertainty contour. electron_drift_velocity (float): Electron drift velocity in cm/ns. fdc_map (str): Path to the 3D field distortion correction map. use_fdc_for_contour (bool): Whether to use full FDC for position reconstruction uncertainty contours.

Columns provided

Field name Data type Comment
s2_position_contour_cnf ('<f4', (17, 2)) Position uncertainty contour for main S2
s2_position_contour_area_cnf float32 Area in position uncertainty contour for main S2
alt_s2_position_contour_cnf ('<f4', (17, 2)) Position uncertainty contour for alternative S2
alt_s2_position_contour_area_cnf float32 Area in position uncertainty contour for alternative S2
position_contour_cnf_fdc ('<f4', (17, 2)) Position uncertainty contour, field-distortion corrected (cm)
x_cnf_fdc float32 Reconstructed cnf S2 X position, field-distortion corrected (cm)
y_cnf_fdc float32 Reconstructed cnf S2 Y position, field-distortion corrected (cm)
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_position_contour event_position_contour event_basics event_basics event_position_contour->event_basics event_positions event_positions event_position_contour->event_positions peak_positions_cnf peak_positions_cnf event_position_contour->peak_positions_cnf peak_basics peak_basics event_position_contour->peak_basics 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 event_positions->event_basics enhanced_peaklet_classification enhanced_peaklet_classification peak_positions_cnf->enhanced_peaklet_classification merged_s2s merged_s2s peak_positions_cnf->merged_s2s peaklet_positions_cnf peaklet_positions_cnf peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peaks peaks peak_basics->peaks events->peak_basics events->peak_proximity peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets peaks->enhanced_peaklet_classification peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 cnf <OMITTED> default reconstruction algorithm that provides (x,y)
electron_drift_velocity xedocs://e...ion=ONLINE <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
fdc_map xedocs://f...ion=ONLINE <OMITTED> 3D field distortion correction map path
n_poly 16 <OMITTED> Size of uncertainty contour
use_fdc_for_contour False <OMITTED> Whether to use full FDC for position reconstruction uncertainty contours. Uses the FDC of the central point if false.

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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_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_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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 0 <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

event_se_score

Description

Provided by plugin: EventSEScore

Data kind: events

This plugin is designed to calculate the single electron rate density for main and alt S2 in

events.

References:

  • v0.0.0: xenon:xenonnt:analysis:hot_spot_cut_summary

  • v0.1.0: xenon:xenonnt:ac:sr1:hotspot_veto_cut:wimp_roi

Columns provided

Field name Data type Comment
s1_se_score float32 Neiboring single-electron score of main S1
alt_s1_se_score float32 Neiboring single-electron score of alternate S1
s2_se_score float32 Neiboring single-electron score of main S2
alt_s2_se_score float32 Neiboring single-electron score of alternate S2
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 event_se_score event_se_score event_basics event_basics event_se_score->event_basics peak_se_score peak_se_score event_se_score->peak_se_score 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_se_score->peak_basics peak_se_score->peak_positions events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_s1 float32 The nearest previous large s1 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_s2 float32 The nearest previous large s2 to main S1 [ns]
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_s1 float32 The nearest previous large s1 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_s2 float32 The nearest previous large s2 to main S2 [ns]
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_shadow peak_shadow event_shadow->peak_shadow 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_shadow->peak_basics peak_shadow->peak_positions events->peak_basics events->peak_proximity peaks peaks peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_basics event_basics event_top_bottom_params->event_basics event_waveform event_waveform event_top_bottom_params->event_waveform 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_waveform->event_basics peaks peaks event_waveform->peaks events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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. 2. 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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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]
cs1_wo_xyzcorr float32 Bias-corrected S1 area before xyz correction [PE]
cs2_wo_xycorr float32 Bias-corrected S2 area before xy correction [PE]
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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_per_event->peak_basics peak_per_event->peak_positions event_basics event_basics peak_per_event->event_basics peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s 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 peak_proximity->peak_positions

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 xedocs://a...attr=value <OMITTED> Nominal single electron (SE) gain in PE / electron extracted. Data will be corrected to this value
b_rel_light_yield 0.0 <OMITTED> b parameter for z-dependent relative light yield correction
check_s2_only_aft True <OMITTED> Whether to check NaN AFT of S2-Only events
cs2_bottom_top_ratio_correction 1 <OMITTED> Scaling factor for cS2 AFT correction due to photoionization
default_reconstruction_algorithm cnf <OMITTED> default reconstruction algorithm that provides (x,y)
electron_drift_time_gate xedocs://e...ion=ONLINE <OMITTED> Electron drift time from the gate in ns
electron_drift_velocity xedocs://e...ion=ONLINE <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
elife xedocs://e...ion=ONLINE <OMITTED> electron lifetime in [ns]
rel_charge_yield 1 <OMITTED> Relative charge yield for SR2 only
rel_extraction_eff take://obj...ion=ONLINE <OMITTED> Relative extraction efficiency for this run (allows for time dependence)
rel_light_yield xedocs://r...ion=ONLINE <OMITTED> Relative light yield (allows for time dependence)
s1_bias_map itp_map://...ion=ONLINE <OMITTED> Interpolation map for S1 peak bias correction. Bias is defined as (reconstructed / raw) - 1.So, the bias correction is reconstructed / (1 + bias).
s1_xyz_map xedocs://s...ion=ONLINE <OMITTED>
s2_bias_map itp_map://...ion=ONLINE <OMITTED> Interpolation map for S2 peak bias correction. Bias is defined as (reconstructed / raw) - 1.So, the bias correction is reconstructed / (1 + bias).
s2_xy_map xedocs://s...ion=ONLINE <OMITTED>
se_gain take://obj...ion=ONLINE <OMITTED> Actual SE gain for a given run (allows for time dependence)
single_electron_gain_partition {'linear': 28, 'circular': 60} <OMITTED> Two distinct patterns of evolution of single electron corrections between AB and CD. Distinguish thanks to linear and circular regions
slope_rel_light_yield 0.0 <OMITTED> Slope parameter for z-dependent relative light yield correction

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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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]
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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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

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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp events->peak_basics events->peak_proximity peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 xedocs), 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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 cnf <OMITTED> default reconstruction algorithm that provides (x,y)
electron_drift_time_gate xedocs://e...ion=ONLINE <OMITTED> Electron drift time from the gate in ns
electron_drift_velocity xedocs://e...ion=ONLINE <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
fdc_map xedocs://f...ion=ONLINE <OMITTED> 3D field distortion correction map path
z_bias_map itp_map://...terpolator <OMITTED> 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 (data) 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_data_start ('<f4', (200,)) Waveform Start 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_data_start ('<f4', (200,)) Waveform Start 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_data_start ('<f4', (200,)) Waveform Start 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_data_start ('<f4', (200,)) Waveform Start 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]
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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s events->peak_basics events->peak_proximity peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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, _cnf) <OMITTED> The list of all reconstruction algorithm considered.

event_basics

Description

Provided by plugin: EventBasicsSOM

Data kind: events

Adds SOM fields for S1 and S2 peaks to event basics.

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 average center time since unix epoch [ns]
alt_s1_center_time int64 Alternate S1 weighted average center time since unix epoch [ns]
s1_median_time float32 Main S1 weighted relative median time of the peak [ns]
alt_s1_median_time float32 Alternate S1 weighted relative median time of the peak [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_top_n_channels int16 Main S1 count of contributing top PMTs
alt_s1_top_n_channels int16 Alternate S1 count of contributing top PMTs
s1_n_hits int32 Main S1 count of hits contributing at least one sample to the peak
alt_s1_n_hits int32 Alternate S1 count of hits contributing at least one sample to the peak
s1_proximity_score float32 Main S1 proximity score in (time, space)
alt_s1_proximity_score float32 Alternate S1 proximity score in (time, space)
s1_n_competing_left int32 Main S1 number of competing peaks left of the main peak
alt_s1_n_competing_left int32 Alternate S1 number of competing peaks left of the main 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
s1_merged bool Main S1 is merged from peaklets
alt_s1_merged bool Alternate S1 is merged from peaklets
s1_vanilla_type int8 Main S1 Vanilla type of the peak(let)
alt_s1_vanilla_type int8 Alternate S1 Vanilla type of the peak(let)
s1_som_type int8 Main S1 SOM type of the peak(let)
alt_s1_som_type int8 Alternate S1 SOM type of the peak(let)
s1_som_sub_type int32 Main S1 SOM subtype of the peak(let)
alt_s1_som_sub_type int32 Alternate S1 SOM subtype of the peak(let)
s1_loc_x_som int16 Main S1 x location of the peak(let) in the SOM
alt_s1_loc_x_som int16 Alternate 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_loc_y_som int16 Alternate S1 y location of the peak(let) in the SOM
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 average center time since unix epoch [ns]
alt_s2_center_time int64 Alternate S2 weighted average center time since unix epoch [ns]
s2_median_time float32 Main S2 weighted relative median time of the peak [ns]
alt_s2_median_time float32 Alternate S2 weighted relative median time of the peak [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_top_n_channels int16 Main S2 count of contributing top PMTs
alt_s2_top_n_channels int16 Alternate S2 count of contributing top PMTs
s2_n_hits int32 Main S2 count of hits contributing at least one sample to the peak
alt_s2_n_hits int32 Alternate S2 count of hits contributing at least one sample to the peak
s2_proximity_score float32 Main S2 proximity score in (time, space)
alt_s2_proximity_score float32 Alternate S2 proximity score in (time, space)
s2_n_competing_left int32 Main S2 number of competing peaks left of the main peak
alt_s2_n_competing_left int32 Alternate S2 number of competing peaks left of the main 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
s2_merged bool Main S2 is merged from peaklets
alt_s2_merged bool Alternate S2 is merged from peaklets
s2_vanilla_type int8 Main S2 Vanilla type of the peak(let)
alt_s2_vanilla_type int8 Alternate S2 Vanilla type of the peak(let)
s2_som_type int8 Main S2 SOM type of the peak(let)
alt_s2_som_type int8 Alternate S2 SOM type of the peak(let)
s2_som_sub_type int32 Main S2 SOM subtype of the peak(let)
alt_s2_som_sub_type int32 Alternate S2 SOM subtype of the peak(let)
s2_loc_x_som int16 Main S2 x location of the peak(let) in the SOM
alt_s2_loc_x_som int16 Alternate S2 x location of the peak(let) in the SOM
s2_loc_y_som int16 Main S2 y location of the peak(let) in the SOM
alt_s2_loc_y_som int16 Alternate S2 y location of the peak(let) in the SOM
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]
s1_first_channel int16 Main S1 first channel/PMT number (sorted by apexes of hits)
alt_s1_first_channel int16 Alternate S1 first channel/PMT number (sorted by apexes of hits)
s1_last_channel int16 Main S1 last channel/PMT number (sorted by apexes of hits)
alt_s1_last_channel int16 Alternate last channel/PMT number (sorted by apexes of hits)
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_area float32 The largest S2 before the Main S2 [PE]
large_s2_before_main_s2_index int32 Index of the largest S2 before the Main S2
large_s2_before_main_s2_center_time int64 Center time of the largest S2 before the Main S2 [ns]
large_s2_after_main_s2_area float32 The largest S2 after the Main S2 [PE]
large_s2_after_main_s2_index int32 Index of the largest S2 after the Main S2
large_s2_after_main_s2_center_time int64 Center time of the largest S2 after the Main S2 [ns]
s2_x_cnf float32 Main S2 cnf-reconstructed X position, uncorrected [cm]
s2_y_cnf float32 Main S2 cnf-reconstructed Y position, uncorrected [cm]
alt_s2_x_cnf float32 Alternate S2 cnf-reconstructed X position, uncorrected [cm]
alt_s2_y_cnf float32 Alternate S2 cnf-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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_proximity->peak_basics peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 xedocs://e...ion=ONLINE <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]

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_proximity”.

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 peak_positions peak_positions peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 xedocs://e...ion=ONLINE <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
event_exclude_s3 True <OMITTED> Event will not be built if S3 is present in the window
event_s1_min_coincidence 2 <OMITTED> Event level S1 min coincidence. Should be >= s1_min_coincidence in the peaklet classification
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_feature proximity_score <OMITTED> Feature as event building criterion
trigger_max_proximity 0.0015 <OMITTED> Peaks must have less proximity score to cause events
trigger_min_area 120 <OMITTED> Peaks must have more area (PE) than this to cause events

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_proximity_score float32 proximity_score of the nearest triggering peak on the left
left_n_competing_left int32 n_competing_left 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_proximity_score float32 proximity_score of the nearest triggering peak on the right
right_n_competing_left int32 n_competing_left 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 peak_positions peak_positions peak_proximity->peak_positions peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 xedocs://e...ion=ONLINE <OMITTED> Vertical electron drift velocity in cm/ns (1e4 m/ms)
event_exclude_s3 True <OMITTED> Event will not be built if S3 is present in the window
event_s1_min_coincidence 2 <OMITTED> Event level S1 min coincidence. Should be >= s1_min_coincidence in the peaklet classification
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_feature proximity_score <OMITTED> Feature as event building criterion
trigger_max_proximity 0.0015 <OMITTED> Peaks must have less proximity score to cause events
trigger_min_area 120 <OMITTED> Peaks must have more area (PE) than this to cause events

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

  • v0.1.0 reference: xenon:xenonnt:analysis:redefine_n_competing

Columns provided

Field name Data type Comment
n_lh_before int16 Number of small lh before a peak
s_lh_before float32 Sum of small lh before a peak
n_s0_before int16 Number of small s0 before a peak
s_s0_before float32 Sum of small s0 before a peak
n_s1_before int16 Number of small s1 before a peak
s_s1_before float32 Sum of small s1 before a peak
n_s2_before int16 Number of small s2 before a peak
s_s2_before float32 Sum of small s2 before a peak
n_s2_near int16 Number of small s2 near a peak
s_s2_near float32 Sum of small s2 near a peak
s_before float32 Sum of small hits and peaks before 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 peak_basics peak_basics peak_ambience->peak_basics peak_positions peak_positions peak_ambience->peak_positions lone_hits lone_hits peak_ambience->lone_hits peaks peaks peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp records records lone_hits->records peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s peaklets->records enhanced_peaklet_classification->lone_hits enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification merged_s2s->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 (30, 30, 60) <OMITTED> The upper limit of S0, S1, S2 area to be counted
ambience_exponents (-1.0, -1.0) <OMITTED> The exponent of (delta t, delta r) when calculating ambience score
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]
gain_model <OMITTED> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value PMT gain model. Specify as URL or explicit 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
proximity_score float32 Strength of proximity peaks in (time, space)
n_competing_left int32 Number of larger or slightly smaller peaks left of the main peak
n_competing int32 Number of nearby larger or slightly smaller peaks
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 peak_positions peak_positions peak_proximity->peak_positions peaks peaks peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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
proximity_exponents (1.0, -1.0, 1.0) <OMITTED> The exponent of (delta t, delta r) when calculating proximity score
proximity_min_area_fraction 0.2 <OMITTED> The area of competing peaks must be at least this fraction of that of the considered peak
proximity_sigma 20.0 <OMITTED> The parameter of HalfCauchy, which is a function of S2 area
proximity_type 2 <OMITTED> (List of) type(s) of peaks to consider for proximity score
proximity_window 10000000 <OMITTED> Peaks starting within this time window (on either side) in ns count as nearby.

peak_se_score

Description

Provided by plugin: PeakSEScore

Data kind: peaks

This plugin is designed to calculate a score based on the position relations to single

electrons.

References:

  • v0.2.0: xenon:xenonnt:analysis:hot_spot_cut_summary

  • v0.4.0: xenon:xenonnt:ac:sr1:hotspot_veto_cut:wimp_roi

  • position resolution: xenon:xenonnt:svetter:data_driven_resolution_sr1a0_vs_sr1a1

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
se_score float32 Sum of the PDF of the SE position nearby probability.

Dependencies

%3 peak_se_score peak_se_score peak_basics peak_basics peak_se_score->peak_basics peak_positions peak_positions peak_se_score->peak_positions peaks peaks peak_basics->peaks peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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
para_a_naive 1 <OMITTED> Place holder for Parameter A in the position resolution function.
para_b_naive 1 <OMITTED> Place holder for Parameter B in the position resolution function.
se_selection_area_roi [10, 80] <OMITTED> Area range for single electron selection.[PE]
se_selection_width_roi [80, 700] <OMITTED> Area range for single electron selection.[PE]
se_time_search_window_left 5000000000.0 <OMITTED> SEs time window searching window, left side [ns]
se_time_search_window_right 0 <OMITTED> Time searching window right side extension, one max drift time [ns]

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_s1 float32 The nearest previous large s1 [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_s2 float32 The nearest previous large s2 [ns]
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_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peak_positions_cnf->enhanced_peaklet_classification peak_positions_cnf->merged_s2s peak_positions_cnf->peaklet_positions_cnf merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp merged_s2_positions_cnf->merged_s2s peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 cnf <OMITTED> default reconstruction algorithm that provides (x,y)
shadow_deltatime_exponent -1.0 <OMITTED> The exponent of delta t when calculating shadow
shadow_merge_dr {'s1_time_shadow': -1, 's2_time_shadow': -1, 's2_position_shadow': -1} <OMITTED> Merge primary peaks within this distance [cm]
shadow_merge_dt {'s1_time_shadow': -1, 's2_time_shadow': -1, 's2_position_shadow': -1} <OMITTED> Merge primary peaks within this time window [ns]
shadow_merge_last_center {'s1_time_shadow': False, 's2_time_shadow': False, 's2_position_shadow': False} <OMITTED> Merge primary peaks but keep the last center time
shadow_merge_replace {'s1_time_shadow': False, 's2_time_shadow': False, 's2_position_shadow': False} <OMITTED> Whether replace the primary peak with the merged peak
shadow_pdf_ordered {'s1_time_shadow': False, 's2_time_shadow': False, 's2_position_shadow': False} <OMITTED> Whether position shadow should be ordered by the position correlation only
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_sum {'s1_time_shadow': False, 's2_time_shadow': True, 's2_position_shadow': False} <OMITTED> Whether the shadow should be summed up rather than taking the largest one
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]
shadow_uncertainty_weights True <OMITTED> Whether to use uncertainty weights when merging peaks

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 enhanced_peaklet_classification enhanced_peaklet_classification peak_positions_mlp->enhanced_peaklet_classification merged_s2s merged_s2s peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp peaklets peaklets peaks->peaklets peaks->enhanced_peaklet_classification peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets lone_hits->records peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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_positions

Description

Provided by plugin: PeakPositions

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_cnf float32 Reconstructed cnf S2 X position (cm), uncorrected
y_cnf float32 Reconstructed cnf S2 Y position (cm), uncorrected
position_contour_cnf ('<f4', (17, 2)) Position uncertainty contour (cm)
position_contour_area_cnf float32 Area in position uncertainty contour (cm^2)
r_uncertainty_cnf float32 Position uncertainty in r (cm)
theta_uncertainty_cnf float32 Position uncertainty in theta (rad)
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 float32 Reconstructed S2 X position (cm), uncorrected
y float32 Reconstructed S2 Y position (cm), uncorrected

Dependencies

%3 peak_positions peak_positions peak_positions_cnf peak_positions_cnf peak_positions->peak_positions_cnf peak_positions_mlp peak_positions_mlp peak_positions->peak_positions_mlp peaklet_positions_cnf peaklet_positions_cnf peak_positions_cnf->peaklet_positions_cnf enhanced_peaklet_classification enhanced_peaklet_classification peak_positions_cnf->enhanced_peaklet_classification merged_s2s merged_s2s peak_positions_cnf->merged_s2s merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peak_positions_mlp->enhanced_peaklet_classification peak_positions_mlp->merged_s2s peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp peaklets peaklets peaklet_positions_cnf->peaklets enhanced_peaklet_classification->peaklet_positions_cnf enhanced_peaklet_classification->peaklets peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklet_positions_cnf merged_s2s->peaklets merged_s2s->peaklet_classification merged_s2s->lone_hits merged_s2_positions_cnf->merged_s2s records records peaklets->records raw_records raw_records records->raw_records peaklet_classification->peaklets lone_hits->records peaklet_positions_mlp->peaklets merged_s2_positions_mlp->merged_s2s

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 cnf <OMITTED> default reconstruction algorithm that provides (x,y)
diagnose_sorting False <OMITTED> Enable runtime checks for sorting and disjointness
diagnose_sorting False <OMITTED> Enable runtime checks for sorting and disjointness
merge_s0 True <OMITTED> Merge S0s into merged S2s
merge_s0 True <OMITTED> Merge S0s into merged S2s

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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s peaklets->records enhanced_peaklet_classification->lone_hits enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification merged_s2s->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->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
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) 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) 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_positions_mlp

Description

Provided by plugin: PeakPositionsMLP

Data kind: peaks

(no plugin description)

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 peaklet_positions_mlp peaklet_positions_mlp peak_positions_mlp->peaklet_positions_mlp enhanced_peaklet_classification enhanced_peaklet_classification peak_positions_mlp->enhanced_peaklet_classification merged_s2s merged_s2s peak_positions_mlp->merged_s2s merged_s2_positions_mlp merged_s2_positions_mlp peak_positions_mlp->merged_s2_positions_mlp peaklets peaklets peaklet_positions_mlp->peaklets enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits merged_s2_positions_mlp->merged_s2s records records peaklets->records raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets 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_s0 True <OMITTED> Merge S0s into merged S2s

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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s peak_basics->peaks records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets 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_basics

Description

Provided by plugin: PeakBasicsSOM

Data kind: peaks

Adds SOM fields to peak basics to be propgated to event basics.

Columns provided

Field name Data type Comment
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]
center_time int64 Weighted average center time of the peak [ns]
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
top_n_channels int16 Number of top 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
length int32 Length of the peak waveform in samples
dt int16 Time resolution of the peak waveform in ns
median_time float32 Weighted relative median time of the peak [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)
merged bool Is merged from peaklets
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]
first_channel int16 First channel/PMT number inside peak (sorted by apexes of hits)
last_channel int16 Last channel/PMT number inside peak (sorted by apexes of hits)
vanilla_type int8 Vanilla type of the peak(let)
som_type int8 SOM type of the peak(let)
som_sub_type int32 SOM subtype 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_basics peak_basics peaks peaks peak_basics->peaks peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets 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_cnf

Description

Provided by plugin: PeakPositionsCNF

Data kind: peaks

(no plugin description)

Columns provided

Field name Data type Comment
x_cnf float32 Reconstructed cnf S2 X position (cm), uncorrected
y_cnf float32 Reconstructed cnf S2 Y position (cm), uncorrected
position_contour_cnf ('<f4', (17, 2)) Position uncertainty contour (cm)
position_contour_area_cnf float32 Area in position uncertainty contour (cm^2)
r_uncertainty_cnf float32 Position uncertainty in r (cm)
theta_uncertainty_cnf float32 Position uncertainty in theta (rad)
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peak_positions_cnf peak_positions_cnf peaklet_positions_cnf peaklet_positions_cnf peak_positions_cnf->peaklet_positions_cnf enhanced_peaklet_classification enhanced_peaklet_classification peak_positions_cnf->enhanced_peaklet_classification merged_s2s merged_s2s peak_positions_cnf->merged_s2s merged_s2_positions_cnf merged_s2_positions_cnf peak_positions_cnf->merged_s2_positions_cnf peaklets peaklets peaklet_positions_cnf->peaklets enhanced_peaklet_classification->peaklet_positions_cnf enhanced_peaklet_classification->peaklets peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklet_positions_cnf merged_s2s->peaklets merged_s2s->peaklet_classification merged_s2s->lone_hits merged_s2_positions_cnf->merged_s2s records records peaklets->records raw_records raw_records records->raw_records peaklet_classification->peaklets 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_s0 True <OMITTED> Merge S0s into merged S2s

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 enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets 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

merged_s2_positions_cnf

Description

Provided by plugin: MergedS2PositionsCNF

Data kind: merged_s2s

(no plugin description)

Columns provided

Field name Data type Comment
x_cnf float32 Reconstructed cnf S2 X position (cm), uncorrected
y_cnf float32 Reconstructed cnf S2 Y position (cm), uncorrected
position_contour_cnf ('<f4', (17, 2)) Position uncertainty contour (cm)
position_contour_area_cnf float32 Area in position uncertainty contour (cm^2)
r_uncertainty_cnf float32 Position uncertainty in r (cm)
theta_uncertainty_cnf float32 Position uncertainty in theta (rad)
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 merged_s2_positions_cnf merged_s2_positions_cnf merged_s2s merged_s2s merged_s2_positions_cnf->merged_s2s peaklets peaklets merged_s2s->peaklets peaklet_positions_cnf peaklet_positions_cnf merged_s2s->peaklet_positions_cnf peaklet_classification peaklet_classification merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits records records peaklets->records peaklet_positions_cnf->peaklets 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
N_chunk_max 4096 <OMITTED> Maximum size of chunk for vectorised JAX function
cnf_pred_function jax://reso...gin.run_id <OMITTED> Compiled JAX function
fix_steps_per_execution True <OMITTED> Fix steps_per_execution to 1 for the model, this is a patch when keras and tensorflow are not fully compatible
log_area_scale 10 <OMITTED> Scaling parameter for log area
min_reconstruction_area 0 <OMITTED> Skip reconstruction if area (PE) is less than this
n_poly 16 <OMITTED> Size of uncertainty contour
n_top_pmts 253 253 Number of top PMTs
sig 0.393 <OMITTED> Confidence level of contour

merged_s2_positions_mlp

Description

Provided by plugin: MergedS2PositionsMLP

Data kind: merged_s2s

(no plugin description)

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 merged_s2_positions_mlp merged_s2_positions_mlp merged_s2s merged_s2s merged_s2_positions_mlp->merged_s2s peaklets peaklets merged_s2s->peaklets peaklet_positions_cnf peaklet_positions_cnf merged_s2s->peaklet_positions_cnf peaklet_classification peaklet_classification merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits records records peaklets->records peaklet_positions_cnf->peaklets 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
fix_steps_per_execution True <OMITTED> Fix steps_per_execution to 1 for the model, this is a patch when keras and tensorflow are not fully compatible
min_reconstruction_area 0 <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

peaks

Description

Provided by plugin: PeaksSOM

Data kind: peaks

Same as Peaks but include in addition SOM type field to be propagated to event_basics.

Thus, only change dtype.

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_fraction_top float32 Fraction of area seen by the top array
area_per_channel ('<f4', (494,)) Integral per channel [PE]
n_hits int32 Number of hits contributing at least one sample to the peak
data_top ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), top array
data_start ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), starting not downsampled samples
data ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!)
center_time int64 Weighted average center time of the peak [ns]
median_time float32 Weighted relative median time of the peak [ns]
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]
first_channel int16 First channel/PMT number inside peak (sorted by apexes of hits)
last_channel int16 Last channel/PMT number inside peak (sorted by apexes of hits)
vanilla_type int8 Vanilla type of the peak(let)
som_type int8 SOM type of the peak(let)
som_sub_type int32 SOM subtype 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
merged bool Peaklet is merging input or peak is merged from peaklets

Dependencies

%3 peaks peaks peaklets peaklets peaks->peaklets enhanced_peaklet_classification enhanced_peaklet_classification peaks->enhanced_peaklet_classification merged_s2s merged_s2s peaks->merged_s2s records records peaklets->records enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits merged_s2s->peaklets merged_s2s->peaklet_positions_cnf merged_s2s->peaklet_classification merged_s2s->lone_hits raw_records raw_records records->raw_records peaklet_positions_cnf->peaklets peaklet_classification->peaklets 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_s0 True <OMITTED> Merge S0s into merged S2s

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.

Technically, the S2 merging algorithm merges S2 peaklets into S2 peaks. By introducing more information about the waveform and (x, y) distribution of potential groups of peaklets, the algorithm removes PI and DE population from S2 peaks.

Note: Types FAR_XYPOS_S2_TYPE (20) and WIDE_XYPOS_S2_TYPE (22) are still S2s, but they do not participate in the event building.

The algorithm merges S2 peaklets when they are close in (t, x, y). But if a group of peaklets is dense in time but sparse in (x, y), the following steps are conducted:

  1. Merge these peaklets that are dense in (x, y).

  2. Assign the peaklets that are dense in time but not dense in (x, y) by type 20,

    they are usually PI or DE.

  3. If the sum of nearby type 20 is large compared to the merged peak,

    assign the merged peak as type 22, because it is usually PI.

Reference: xenon:xenonnt:analysis:s2_merging_time_position xenon:xenonnt:analysis:sr2_peak_types

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)
vanilla_type int8 Vanilla type of the peak(let)
som_type int8 SOM type of the peak(let)
som_sub_type int32 SOM subtype 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
area float32 Integral across channels [PE]
area_fraction_top float32 Fraction of area seen by the top array
area_per_channel ('<f4', (494,)) Integral per channel [PE]
n_hits int32 Number of hits contributing at least one sample to the peak
data_top ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), top array
data_start ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), starting not downsampled samples
data ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!)
center_time int64 Weighted average center time of the peak [ns]
median_time float32 Weighted relative median time of the peak [ns]
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]
first_channel int16 First channel/PMT number inside peak (sorted by apexes of hits)
last_channel int16 Last channel/PMT number inside peak (sorted by apexes of hits)
merged bool Peaklet is merging input or peak is merged from peaklets

Dependencies

%3 merged_s2s merged_s2s peaklets peaklets merged_s2s->peaklets peaklet_positions_cnf peaklet_positions_cnf merged_s2s->peaklet_positions_cnf peaklet_classification peaklet_classification merged_s2s->peaklet_classification lone_hits lone_hits merged_s2s->lone_hits records records peaklets->records peaklet_positions_cnf->peaklets 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
default_reconstruction_algorithm cnf <OMITTED> default reconstruction algorithm that provides (x,y)
disable_progress_bar True <OMITTED> Whether to disable the progress bar
gain_model <OMITTED> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value PMT gain model. Specify as (str(model_config), str(version), nT-->boolean
maxexp 10 <OMITTED> Maximum exponent for the posterior to keep numerical stability
merge_lone_hits True <OMITTED> Merge lone hits into merged S2s
merge_s0 True <OMITTED> Merge S0s into merged S2s
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
normal_max_sigma 7 <OMITTED> Maximum sigma for the normal distribution CDF panel
normal_n_bins 501 <OMITTED> Number of bins for the normal distribution CDF panel
p_value_prioritized False <OMITTED> Whether to prioritize p-value over area when testing the proposal
poisson_max_mu 25 <OMITTED> When to switch from Poisson to normal distribution
poisson_survival_ratio 0.0001 <OMITTED> Survival ratio for Poisson distribution. The PMF smaller than this will be ignored.
rm_sparse_xy True <OMITTED> Remove peaklets that are too far away in (x, y)
rough_max_sigma 20000.0 <OMITTED> Maximum sigma for the merged peaks
rough_min_sigma 100.0 <OMITTED> Minimum sigma for the merged peaks
rough_mu_bins 10 <OMITTED> Number of bins for mu of merged peaks
rough_seg 30 <OMITTED> Rough single electron gain [PE/e]
rough_sigma_bins 10 <OMITTED> Number of bins for sigma of merged peaks
s2_merge_dr_thresholds ((1.51, 14.0), (1.84, 18.3), (2.18, 19.7), (2.51, 12.4), (2.84, 5.75)) <OMITTED> Points to define maximum weighted mean deviation of the peaklets from the main cluster [cm]\nThe format is ((log10(area_top), dr), (..., ...), (..., ...))
s2_merge_gap_thresholds ((1.84, 28400.0), (2.18, 24000.0), (2.51, 19600.0), (2.84, 18000.0), (3.18, 16800.0), (3.51, 18600.0), (3.84, 19800.0), (4.18, 16600.0), (4.51, 12100.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 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]
s2_merge_p_thresholds ((4.18, 0.000989), (4.51, 0.00715), (4.84, 0.16)) <OMITTED> Points to define minimum p-value of merging proposal depending on log10 area of the merged peak\nThe format is ((log10(area), p-value), (..., ...), (..., ...))
s2_merge_unmerged_thresholds (1, 49.5, 0.01) <OMITTED> Max (number, fraction of unmerged, total area of unmerged) of type 20 peaklets inside a peak. The number of type 20 peaklets should not be larger than the number threshold. The area of type 20 peaklets should not be larger than the both area thresholds. The fraction threshold is important when S2 is large, while the total area threshold is important when S2 is small.
sigma_seg 6.5 <OMITTED> Standard deviation of the single electron gain [PE/e]
use_bayesian_merging True <OMITTED> Use Bayesian merging
use_uncertainty_weights True <OMITTED> Use uncertainty from probabilistic posrec to derive weights

enhanced_peaklet_classification

Description

Provided by plugin: MergedS2s

Data kind: peaklets

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

Technically, the S2 merging algorithm merges S2 peaklets into S2 peaks. By introducing more information about the waveform and (x, y) distribution of potential groups of peaklets, the algorithm removes PI and DE population from S2 peaks.

Note: Types FAR_XYPOS_S2_TYPE (20) and WIDE_XYPOS_S2_TYPE (22) are still S2s, but they do not participate in the event building.

The algorithm merges S2 peaklets when they are close in (t, x, y). But if a group of peaklets is dense in time but sparse in (x, y), the following steps are conducted:

  1. Merge these peaklets that are dense in (x, y).

  2. Assign the peaklets that are dense in time but not dense in (x, y) by type 20,

    they are usually PI or DE.

  3. If the sum of nearby type 20 is large compared to the merged peak,

    assign the merged peak as type 22, because it is usually PI.

Reference: xenon:xenonnt:analysis:s2_merging_time_position xenon:xenonnt:analysis:sr2_peak_types

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)
vanilla_type int8 Vanilla type of the peak(let)
som_type int8 SOM type of the peak(let)
som_sub_type int32 SOM subtype 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
merged bool Peaklet is merging input or peak is merged from peaklets

Dependencies

%3 enhanced_peaklet_classification enhanced_peaklet_classification peaklets peaklets enhanced_peaklet_classification->peaklets peaklet_positions_cnf peaklet_positions_cnf enhanced_peaklet_classification->peaklet_positions_cnf peaklet_classification peaklet_classification enhanced_peaklet_classification->peaklet_classification lone_hits lone_hits enhanced_peaklet_classification->lone_hits records records peaklets->records peaklet_positions_cnf->peaklets 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
default_reconstruction_algorithm cnf <OMITTED> default reconstruction algorithm that provides (x,y)
disable_progress_bar True <OMITTED> Whether to disable the progress bar
gain_model <OMITTED> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value PMT gain model. Specify as (str(model_config), str(version), nT-->boolean
maxexp 10 <OMITTED> Maximum exponent for the posterior to keep numerical stability
merge_lone_hits True <OMITTED> Merge lone hits into merged S2s
merge_s0 True <OMITTED> Merge S0s into merged S2s
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
normal_max_sigma 7 <OMITTED> Maximum sigma for the normal distribution CDF panel
normal_n_bins 501 <OMITTED> Number of bins for the normal distribution CDF panel
p_value_prioritized False <OMITTED> Whether to prioritize p-value over area when testing the proposal
poisson_max_mu 25 <OMITTED> When to switch from Poisson to normal distribution
poisson_survival_ratio 0.0001 <OMITTED> Survival ratio for Poisson distribution. The PMF smaller than this will be ignored.
rm_sparse_xy True <OMITTED> Remove peaklets that are too far away in (x, y)
rough_max_sigma 20000.0 <OMITTED> Maximum sigma for the merged peaks
rough_min_sigma 100.0 <OMITTED> Minimum sigma for the merged peaks
rough_mu_bins 10 <OMITTED> Number of bins for mu of merged peaks
rough_seg 30 <OMITTED> Rough single electron gain [PE/e]
rough_sigma_bins 10 <OMITTED> Number of bins for sigma of merged peaks
s2_merge_dr_thresholds ((1.51, 14.0), (1.84, 18.3), (2.18, 19.7), (2.51, 12.4), (2.84, 5.75)) <OMITTED> Points to define maximum weighted mean deviation of the peaklets from the main cluster [cm]\nThe format is ((log10(area_top), dr), (..., ...), (..., ...))
s2_merge_gap_thresholds ((1.84, 28400.0), (2.18, 24000.0), (2.51, 19600.0), (2.84, 18000.0), (3.18, 16800.0), (3.51, 18600.0), (3.84, 19800.0), (4.18, 16600.0), (4.51, 12100.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 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]
s2_merge_p_thresholds ((4.18, 0.000989), (4.51, 0.00715), (4.84, 0.16)) <OMITTED> Points to define minimum p-value of merging proposal depending on log10 area of the merged peak\nThe format is ((log10(area), p-value), (..., ...), (..., ...))
s2_merge_unmerged_thresholds (1, 49.5, 0.01) <OMITTED> Max (number, fraction of unmerged, total area of unmerged) of type 20 peaklets inside a peak. The number of type 20 peaklets should not be larger than the number threshold. The area of type 20 peaklets should not be larger than the both area thresholds. The fraction threshold is important when S2 is large, while the total area threshold is important when S2 is small.
sigma_seg 6.5 <OMITTED> Standard deviation of the single electron gain [PE/e]
use_bayesian_merging True <OMITTED> Use Bayesian merging
use_uncertainty_weights True <OMITTED> Use uncertainty from probabilistic posrec to derive weights

peaklet_classification

Description

Provided by plugin: PeakletClassificationSOM

Data kind: peaklets

Self-Organizing Maps (SOM) https://xe1t-wiki.lngs.infn.it/doku.php?id=xenon:xenonnt:lsanchez:unsupervised_neural_network_som_methods https://xe1t-wiki.lngs.infn.it/doku.php?id=xenon:xenonnt:lsanchez:som_summary_note For peaklet classification. We this pluggin will provide 2 data types, the ‘type’ we are already familiar with, classifying peaklets as s1, s2 (using the new classification) or unknown (from the previous classification). As well as a new data type, SOM type, which will be assigned numbers based on the cluster in the SOM in which they are found. For each version I will make some documentation in the corrections repository explaining what I believe each cluster represents.

This correction/plugin is currently on the testing phase, feel free to use it if you are curious or just want to test it or try it out but note this is note ready to be used in analysis.

Here data will be classified into one of four types:
Type 0: Unknown, these are all data that associated with being non-physical like

dark counts or unknown signals that do not seem to come from interactions of interest in our detector.

Type 1: S1 interactions produced by excited xenon molecules in the liquid xenon Type 2: S2 interactions produced when freed electrons in the LXe breach the liquid

gas interface.

Type 3: Gas events. S1 interactions that occur on the GXe instead of the liquid.

Have S1 waveform shape, with higher AFT.

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)
vanilla_type int8 Vanilla type of the peak(let)
som_type int8 SOM type of the peak(let)
som_sub_type int32 SOM subtype 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 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
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:/...id&fmt=npy <OMITTED>
use_som_as_default True <OMITTED> Boolean to indicate whether to use SOM or the straxen classifcation method for peaklet classification.

peaklet_positions_cnf

Description

Provided by plugin: PeakletPositionsCNF

Data kind: peaklets

Conditional Normalizing Flow for position reconstruction.

This plugin reconstructs the position of peaklets using a conditional normalizing flow model. It provides x and y coordinates of the reconstructed position, along with uncertainty contours and uncertainty estimates in r and theta. For information on the model, see note.

Configuration options: - min_reconstruction_area: Minimum area (PE) required for reconstruction - n_poly: Size of the uncertainty contour - sig: Confidence level of the contour - log_area_scale: Scaling parameter for log area - n_top_pmts: Number of top PMTs - cnf_pred_function: Path to the compiled JAX function for predictions

Columns provided

Field name Data type Comment
x_cnf float32 Reconstructed cnf S2 X position (cm), uncorrected
y_cnf float32 Reconstructed cnf S2 Y position (cm), uncorrected
position_contour_cnf ('<f4', (17, 2)) Position uncertainty contour (cm)
position_contour_area_cnf float32 Area in position uncertainty contour (cm^2)
r_uncertainty_cnf float32 Position uncertainty in r (cm)
theta_uncertainty_cnf float32 Position uncertainty in theta (rad)
time int64 Start time since unix epoch [ns]
endtime int64 Exclusive end time since unix epoch [ns]

Dependencies

%3 peaklet_positions_cnf peaklet_positions_cnf peaklets peaklets peaklet_positions_cnf->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_chunk_max 4096 <OMITTED> Maximum size of chunk for vectorised JAX function
cnf_pred_function jax://reso...gin.run_id <OMITTED> Compiled JAX function
fix_steps_per_execution True <OMITTED> Fix steps_per_execution to 1 for the model, this is a patch when keras and tensorflow are not fully compatible
log_area_scale 10 <OMITTED> Scaling parameter for log area
min_reconstruction_area 0 <OMITTED> Skip reconstruction if area (PE) is less than this
n_poly 16 <OMITTED> Size of uncertainty contour
n_top_pmts 253 253 Number of top PMTs
sig 0.393 <OMITTED> Confidence level of contour

peaklet_positions_mlp

Description

Provided by plugin: PeakletPositionsMLP

Data kind: peaklets

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 peaklet_positions_mlp peaklet_positions_mlp peaklets peaklets peaklet_positions_mlp->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
fix_steps_per_execution True <OMITTED> Fix steps_per_execution to 1 for the model, this is a patch when keras and tensorflow are not fully compatible
min_reconstruction_area 0 <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

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_fraction_top float32 Fraction of area seen by the top array
area_per_channel ('<f4', (494,)) Integral per channel [PE]
n_hits int32 Number of hits contributing at least one sample to the peak
data_top ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), top array
data_start ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!), starting not downsampled samples
data ('<f4', (200,)) Waveform data in PE/sample (not PE/ns!)
center_time int64 Weighted average center time of the peak [ns]
median_time float32 Weighted relative median time of the peak [ns]
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]
first_channel int16 First channel/PMT number inside peak (sorted by apexes of hits)
last_channel int16 Last channel/PMT number inside peak (sorted by apexes of hits)

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> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value PMT gain model. Specify as URL or explicit value
hit_min_amplitude list-to-ar...ion=ONLINE <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.py
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
store_data_start True <OMITTED> Save the start time of the waveform with minimum dt
store_data_top True <OMITTED> Save 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]
max_time int64 Time when hit reach maximum amplitude [ns]

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> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value PMT gain model. Specify as URL or explicit value
hit_min_amplitude list-to-ar...ion=ONLINE <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.py
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
store_data_start True <OMITTED> Save the start time of the waveform with minimum dt
store_data_top True <OMITTED> Save 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 list-to-ar...ion=ONLINE <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.py
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]
max_time int64 Time when hit reach maximum amplitude [ns]

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 list-to-ar...ion=ONLINE <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.py
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 list-to-ar...ion=ONLINE <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.py
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

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]
max_time int64 Time when hit reach maximum amplitude [ns]

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

Plugin for processing LED afterpulses.

Detect LED pulses and afterpulses (APs) in raw_records waveforms. Compute the AP datatype.

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 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_hit_left_boundary 50 <OMITTED> Left boundary after which the first hit marks the position of the LED window
LED_hit_right_boundary 110 <OMITTED> Right boundary after which the LED hit will no longer be searched
LED_window_width 20 <OMITTED> Width of the window in which hits are merged into the LED hit after the first hit
baseline_samples 40 <OMITTED> Number of samples to use at start of WF to determine the baseline
gain_model <OMITTED> list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value PMT gain model. Specify as (model_type, model_config)
hit_min_amplitude list-to-ar...ion=ONLINE <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 "xedocs://hit_thresholds_tpc?version=ONLINE" which meanscalling xedocs.
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

LEDCalibration Plugin for PMT LED signal analysis.

This plugin processes raw PMT data and extracts various calibration parameters related to LED signals and noise. It is used during PMT calibration runs to measure LED pulse amplitudes, noise characteristics, and other relevant metrics. The analysis assumes a fixed LED window and computes parameters for both LED-on and LED-off runs.

Key Features:

  • Extracts LED and noise amplitudes.

  • Computes the area of LED pulses using multiple integration windows for noise mitigation.

  • Identifies triggered intervals based on hits.

Returned Variables:

  • area: Area under the LED pulse, averaged over multiple integration windows.

  • area_noise: Area in a noise window far from the LED signal.

  • amplitude_led: Peak amplitude of the LED signal.

  • amplitude_noise: Peak amplitude in a noise window.

  • channel: PMT channel identifier.

  • time: Start time of the interval (ns since UNIX epoch).

  • dt: Time resolution in nanoseconds.

  • length: Length of the interval in samples.

  • triggered: Boolean indicating if a hit was found in the record.

  • hit_position: Sample index of the hit defining the window position.

  • integration_window: Integration window used for area calculations.

  • baseline: Baseline of the record.

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 Area averaged in integration windows
area_noise float32 Area averaged in noise integration windows
amplitude_led float32 Amplitude in LED window
amplitude_noise float32 Amplitude in off LED window
triggered bool Whether there was a hit found in the record
hit_position uint8 Sample index of the hit that defines the window position
integration_window ('u1', (2,)) Window used for integration
baseline float32 Baseline from the record

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
area_averaging_length 7 <OMITTED> The total length of the averaging window for the area calculation. To mitigate a possiple bias from noise, the area is integrated multiple times with sligntly different window lengths and then averaged. area_averaging_length should be divisible by area_averaging_step.
area_averaging_step 1 <OMITTED> The step size used for the different windows, averaged for the area calculation. To mitigate a possiple bias from noise, the area is integrated multiple times with sligntly different window lengths and then averaged. area_averaging_length should be divisible by area_averaging_step.
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
default_run_comments [auto, SC user: , pulserScript: ] <OMITTED> List of default comments the automatic script for runs in PMT calibration.
fixed_led_window (78, 142) <OMITTED> Window (samples) where we expect the signal in LED calibration
fixed_position 88 <OMITTED> Fixed ADC sample upon which the integration window is defined. This is used as default when no hits or less than a certain amount are identified.
led_cal_hit_min_height_over_noise 6 <OMITTED> Minimum hit amplitude in numbers of baseline_rms above baseline.
led_cal_record_length 160 <OMITTED> Length (samples) of one record without 0 padding.
led_hit_extension (-8, 32) <OMITTED> The extension around the LED hit to integrate.
minimum_led_position 60 <OMITTED> The minimum sample index to consider for LED hits. Hits before this sample are ignored.
noise_run_comments [SPE_calibration_step0, Gain_calibration_step3] <OMITTED> List of comments for noise runs in PMT calibration.
noise_window (1, 65) <OMITTED> Window (samples) to analysis the noise
run_doc run_doc://...gin.run_id <OMITTED> Comments dictionary from the run metadata. It is used for discriminate between LED on and LED off runs.

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.