Straxen 1T datastructure

This page is an autogenerated reference for all the plugins in straxen’s xenon1t_dali 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_info_double

Description

Provided by plugin: EventInfoDouble

Data kind: events

Alternate version of event_info for Kr and other double scatter.

analyses:

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

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

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cs1_a	float32	Corrected area of main S1 [PE]
cs1_a_wo_timecorr	float32	Corrected area of main S1 (before LY correction) [PE]
cs2_a_wo_timecorr	float32	Corrected area of main S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
cs2_area_fraction_top_wo_timecorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before SEG/EE + photon ionization, after S2 xy + elife)
cs2_wo_picorr	float32	Corrected area of main S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
cs2_area_fraction_top_wo_picorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_a_wo_elifecorr	float32	Corrected area of main S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
cs2_area_fraction_top_wo_elifecorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2_a	float32	Corrected area of main S2 [PE]
cs2_a_area_fraction_top	float32	Fraction of area seen by the top PMT array for corrected main S2
cs1_b	float32	Corrected area of alternate S1 [PE]
cs1_b_wo_timecorr	float32	Corrected area of alternate S1 (before LY correction) [PE]
cs2_b_wo_timecorr	float32	Corrected area of alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
alt_cs2_area_fraction_top_wo_timecorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife)
alt_cs2_wo_picorr	float32	Corrected area of alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
alt_cs2_area_fraction_top_wo_picorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_b_wo_elifecorr	float32	Corrected area of alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
alt_cs2_area_fraction_top_wo_elifecorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2_b	float32	Corrected area of alternate S2 [PE]
cs2_b_area_fraction_top	float32	Fraction of area seen by the top PMT array for corrected alternate S2
e_light	float32	Energy in light signal [keVee]
e_charge	float32	Energy in charge signal [keVee]
e_ces	float32	Energy estimate [keVee]
n_peaks	int32	Number of peaks in the event
drift_time	float32	Drift time between main S1 and S2 in ns
event_number	int64	Event number in this dataset
s1_a_index	int32	Main S1 peak index in event
s1_b_index	int32	Alternate S1 peak index in event
s1_a_time	int64	Main S1 start time since unix epoch [ns]
s1_b_time	int64	Alternate S1 start time since unix epoch [ns]
s1_a_center_time	int64	Main S1 weighted center time since unix epoch [ns]
s1_b_center_time	int64	Alternate S1 weighted center time since unix epoch [ns]
s1_a_endtime	int64	Main S1 end time since unix epoch [ns]
s1_b_endtime	int64	Alternate S1 end time since unix epoch [ns]
s1_a_area	float32	Main S1 area, uncorrected [PE]
s1_b_area	float32	Alternate S1 area, uncorrected [PE]
s1_a_n_channels	int16	Main S1 count of contributing PMTs
s1_b_n_channels	int16	Alternate S1 count of contributing PMTs
s1_a_n_hits	int16	Main S1 count of hits contributing at least one sample to the peak
s1_b_n_hits	int16	Alternate S1 count of hits contributing at least one sample to the peak
s1_a_n_competing	int32	Main S1 number of competing peaks
s1_b_n_competing	int32	Alternate S1 number of competing peaks
s1_a_max_pmt	int16	Main S1 PMT number which contributes the most PE
s1_b_max_pmt	int16	Alternate S1 PMT number which contributes the most PE
s1_a_max_pmt_area	float32	Main S1 area in the largest-contributing PMT (PE)
s1_b_max_pmt_area	float32	Alternate S1 area in the largest-contributing PMT (PE)
s1_a_range_50p_area	float32	Main S1 width, 50% area [ns]
s1_b_range_50p_area	float32	Alternate S1 width, 50% area [ns]
s1_a_range_90p_area	float32	Main S1 width, 90% area [ns]
s1_b_range_90p_area	float32	Alternate S1 width, 90% area [ns]
s1_a_rise_time	float32	Main S1 time between 10% and 50% area quantiles [ns]
s1_b_rise_time	float32	Alternate S1 time between 10% and 50% area quantiles [ns]
s1_a_area_fraction_top	float32	Main S1 fraction of area seen by the top PMT array
s1_b_area_fraction_top	float32	Alternate S1 fraction of area seen by the top PMT array
s1_a_tight_coincidence	int16	Main S1 Channel within tight range of mean
s1_b_tight_coincidence	int16	Alternate S1 Channel within tight range of mean
s1_a_n_saturated_channels	int16	Main S1 Total number of saturated channels
s1_b_n_saturated_channels	int16	Alternate S1 Total number of saturated channels
s1_b_interaction_drift_time	float32	Drift time using alternate S1 [ns]
ds_s1_dt	int32	Time between main and alternate S1 [ns]
s2_a_index	int32	Main S2 peak index in event
s2_b_index	int32	Alternate S2 peak index in event
s2_a_time	int64	Main S2 start time since unix epoch [ns]
s2_b_time	int64	Alternate S2 start time since unix epoch [ns]
s2_a_center_time	int64	Main S2 weighted center time since unix epoch [ns]
s2_b_center_time	int64	Alternate S2 weighted center time since unix epoch [ns]
s2_a_endtime	int64	Main S2 end time since unix epoch [ns]
s2_b_endtime	int64	Alternate S2 end time since unix epoch [ns]
s2_a_area	float32	Main S2 area, uncorrected [PE]
s2_b_area	float32	Alternate S2 area, uncorrected [PE]
s2_a_n_channels	int16	Main S2 count of contributing PMTs
s2_b_n_channels	int16	Alternate S2 count of contributing PMTs
s2_a_n_hits	int16	Main S2 count of hits contributing at least one sample to the peak
s2_b_n_hits	int16	Alternate S2 count of hits contributing at least one sample to the peak
s2_a_n_competing	int32	Main S2 number of competing peaks
s2_b_n_competing	int32	Alternate S2 number of competing peaks
s2_a_max_pmt	int16	Main S2 PMT number which contributes the most PE
s2_b_max_pmt	int16	Alternate S2 PMT number which contributes the most PE
s2_a_max_pmt_area	float32	Main S2 area in the largest-contributing PMT (PE)
s2_b_max_pmt_area	float32	Alternate S2 area in the largest-contributing PMT (PE)
s2_a_range_50p_area	float32	Main S2 width, 50% area [ns]
s2_b_range_50p_area	float32	Alternate S2 width, 50% area [ns]
s2_a_range_90p_area	float32	Main S2 width, 90% area [ns]
s2_b_range_90p_area	float32	Alternate S2 width, 90% area [ns]
s2_a_rise_time	float32	Main S2 time between 10% and 50% area quantiles [ns]
s2_b_rise_time	float32	Alternate S2 time between 10% and 50% area quantiles [ns]
s2_a_area_fraction_top	float32	Main S2 fraction of area seen by the top PMT array
s2_b_area_fraction_top	float32	Alternate S2 fraction of area seen by the top PMT array
s2_a_tight_coincidence	int16	Main S2 Channel within tight range of mean
s2_b_tight_coincidence	int16	Alternate S2 Channel within tight range of mean
s2_a_n_saturated_channels	int16	Main S2 Total number of saturated channels
s2_b_n_saturated_channels	int16	Alternate S2 Total number of saturated channels
s2_b_interaction_drift_time	float32	Drift time using alternate S2 [ns]
ds_s2_dt	int32	Time between main and alternate S2 [ns]
s1_a_max_diff	int32	Main S1 largest time difference between apexes of hits [ns]
s1_b_max_diff	int32	Alternate S1 largest time difference between apexes of hits [ns]
s1_a_min_diff	int32	Main S1 smallest time difference between apexes of hits [ns]
s1_b_min_diff	int32	Alternate S1 smallest time difference between apexes of hits [ns]
s2_a_x	float32	Main S2 reconstructed X position, uncorrected [cm]
s2_a_y	float32	Main S2 reconstructed Y position, uncorrected [cm]
s2_b_x	float32	Alternate S2 reconstructed X position, uncorrected [cm]
s2_b_y	float32	Alternate S2 reconstructed Y position, uncorrected [cm]
area_before_main_s2	float32	Sum of areas before Main S2 [PE]
large_s2_before_main_s2	float32	The largest S2 before the Main S2 [PE]
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

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

---

fiducial_events

Description

Provided by plugin: FiducialEvents

Data kind: fiducial_events

(no plugin description)

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cs1	float32	Corrected area of main S1 [PE]
cs1_wo_timecorr	float32	Corrected area of main S1 (before LY correction) [PE]
cs2_wo_timecorr	float32	Corrected area of main S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
cs2_area_fraction_top_wo_timecorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before SEG/EE + photon ionization, after S2 xy + elife)
cs2_wo_picorr	float32	Corrected area of main S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
cs2_area_fraction_top_wo_picorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_wo_elifecorr	float32	Corrected area of main S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
cs2_area_fraction_top_wo_elifecorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2	float32	Corrected area of main S2 [PE]
cs2_area_fraction_top	float32	Fraction of area seen by the top PMT array for corrected main S2
alt_cs1	float32	Corrected area of alternate S1 [PE]
alt_cs1_wo_timecorr	float32	Corrected area of alternate S1 (before LY correction) [PE]
alt_cs2_wo_timecorr	float32	Corrected area of alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
alt_cs2_area_fraction_top_wo_timecorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife)
alt_cs2_wo_picorr	float32	Corrected area of alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
alt_cs2_area_fraction_top_wo_picorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE)
alt_cs2_wo_elifecorr	float32	Corrected area of alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
alt_cs2_area_fraction_top_wo_elifecorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization)
alt_cs2	float32	Corrected area of alternate S2 [PE]
alt_cs2_area_fraction_top	float32	Fraction of area seen by the top PMT array for corrected alternate S2
e_light	float32	Energy in light signal [keVee]
e_charge	float32	Energy in charge signal [keVee]
e_ces	float32	Energy estimate [keVee]
n_peaks	int32	Number of peaks in the event
drift_time	float32	Drift time between main S1 and S2 in ns
event_number	int64	Event number in this dataset
s1_index	int32	Main S1 peak index in event
alt_s1_index	int32	Alternate S1 peak index in event
s1_time	int64	Main S1 start time since unix epoch [ns]
alt_s1_time	int64	Alternate S1 start time since unix epoch [ns]
s1_center_time	int64	Main S1 weighted center time since unix epoch [ns]
alt_s1_center_time	int64	Alternate S1 weighted center time since unix epoch [ns]
s1_endtime	int64	Main S1 end time since unix epoch [ns]
alt_s1_endtime	int64	Alternate S1 end time since unix epoch [ns]
s1_area	float32	Main S1 area, uncorrected [PE]
alt_s1_area	float32	Alternate S1 area, uncorrected [PE]
s1_n_channels	int16	Main S1 count of contributing PMTs
alt_s1_n_channels	int16	Alternate S1 count of contributing PMTs
s1_n_hits	int16	Main S1 count of hits contributing at least one sample to the peak
alt_s1_n_hits	int16	Alternate S1 count of hits contributing at least one sample to the peak
s1_n_competing	int32	Main S1 number of competing peaks
alt_s1_n_competing	int32	Alternate S1 number of competing peaks
s1_max_pmt	int16	Main S1 PMT number which contributes the most PE
alt_s1_max_pmt	int16	Alternate S1 PMT number which contributes the most PE
s1_max_pmt_area	float32	Main S1 area in the largest-contributing PMT (PE)
alt_s1_max_pmt_area	float32	Alternate S1 area in the largest-contributing PMT (PE)
s1_range_50p_area	float32	Main S1 width, 50% area [ns]
alt_s1_range_50p_area	float32	Alternate S1 width, 50% area [ns]
s1_range_90p_area	float32	Main S1 width, 90% area [ns]
alt_s1_range_90p_area	float32	Alternate S1 width, 90% area [ns]
s1_rise_time	float32	Main S1 time between 10% and 50% area quantiles [ns]
alt_s1_rise_time	float32	Alternate S1 time between 10% and 50% area quantiles [ns]
s1_area_fraction_top	float32	Main S1 fraction of area seen by the top PMT array
alt_s1_area_fraction_top	float32	Alternate S1 fraction of area seen by the top PMT array
s1_tight_coincidence	int16	Main S1 Channel within tight range of mean
alt_s1_tight_coincidence	int16	Alternate S1 Channel within tight range of mean
s1_n_saturated_channels	int16	Main S1 Total number of saturated channels
alt_s1_n_saturated_channels	int16	Alternate S1 Total number of saturated channels
alt_s1_interaction_drift_time	float32	Drift time using alternate S1 [ns]
alt_s1_delay	int32	Time between main and alternate S1 [ns]
s2_index	int32	Main S2 peak index in event
alt_s2_index	int32	Alternate S2 peak index in event
s2_time	int64	Main S2 start time since unix epoch [ns]
alt_s2_time	int64	Alternate S2 start time since unix epoch [ns]
s2_center_time	int64	Main S2 weighted center time since unix epoch [ns]
alt_s2_center_time	int64	Alternate S2 weighted center time since unix epoch [ns]
s2_endtime	int64	Main S2 end time since unix epoch [ns]
alt_s2_endtime	int64	Alternate S2 end time since unix epoch [ns]
s2_area	float32	Main S2 area, uncorrected [PE]
alt_s2_area	float32	Alternate S2 area, uncorrected [PE]
s2_n_channels	int16	Main S2 count of contributing PMTs
alt_s2_n_channels	int16	Alternate S2 count of contributing PMTs
s2_n_hits	int16	Main S2 count of hits contributing at least one sample to the peak
alt_s2_n_hits	int16	Alternate S2 count of hits contributing at least one sample to the peak
s2_n_competing	int32	Main S2 number of competing peaks
alt_s2_n_competing	int32	Alternate S2 number of competing peaks
s2_max_pmt	int16	Main S2 PMT number which contributes the most PE
alt_s2_max_pmt	int16	Alternate S2 PMT number which contributes the most PE
s2_max_pmt_area	float32	Main S2 area in the largest-contributing PMT (PE)
alt_s2_max_pmt_area	float32	Alternate S2 area in the largest-contributing PMT (PE)
s2_range_50p_area	float32	Main S2 width, 50% area [ns]
alt_s2_range_50p_area	float32	Alternate S2 width, 50% area [ns]
s2_range_90p_area	float32	Main S2 width, 90% area [ns]
alt_s2_range_90p_area	float32	Alternate S2 width, 90% area [ns]
s2_rise_time	float32	Main S2 time between 10% and 50% area quantiles [ns]
alt_s2_rise_time	float32	Alternate S2 time between 10% and 50% area quantiles [ns]
s2_area_fraction_top	float32	Main S2 fraction of area seen by the top PMT array
alt_s2_area_fraction_top	float32	Alternate S2 fraction of area seen by the top PMT array
s2_tight_coincidence	int16	Main S2 Channel within tight range of mean
alt_s2_tight_coincidence	int16	Alternate S2 Channel within tight range of mean
s2_n_saturated_channels	int16	Main S2 Total number of saturated channels
alt_s2_n_saturated_channels	int16	Alternate S2 Total number of saturated channels
alt_s2_interaction_drift_time	float32	Drift time using alternate S2 [ns]
alt_s2_delay	int32	Time between main and alternate S2 [ns]
s1_max_diff	int32	Main S1 largest time difference between apexes of hits [ns]
alt_s1_max_diff	int32	Alternate S1 largest time difference between apexes of hits [ns]
s1_min_diff	int32	Main S1 smallest time difference between apexes of hits [ns]
alt_s1_min_diff	int32	Alternate S1 smallest time difference between apexes of hits [ns]
s2_x	float32	Main S2 reconstructed X position, uncorrected [cm]
s2_y	float32	Main S2 reconstructed Y position, uncorrected [cm]
alt_s2_x	float32	Alternate S2 reconstructed X position, uncorrected [cm]
alt_s2_y	float32	Alternate S2 reconstructed Y position, uncorrected [cm]
area_before_main_s2	float32	Sum of areas before Main S2 [PE]
large_s2_before_main_s2	float32	The largest S2 before the Main S2 [PE]
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)
cut_fiducial_cylinder_1t	bool	One tonne fiducial cylinder

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

sr1_cuts

Description

Provided by plugin: SR1Cuts

Data kind: events

(no plugin description)

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_fiducial_cylinder_1t	bool	One tonne fiducial cylinder
cut_s1_low_energy_range	bool	Event under 200pe
cut_s1_max_pmt	bool	S1 max PMT cut

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

cut_s1_single_scatter

Description

Provided by plugin: S1SingleScatter

Data kind: events

Requires only one valid interaction between the largest S2, and any S1 recorded before it.

The S1 cut checks that any possible secondary S1s recorded in a waveform, could not have also produced a valid interaction with the primary S2. To check whether an interaction between the second largest S1 and the largest S2 is valid, we use the S2Width cut. If the event would pass the S2Width cut, a valid second interaction exists, and we may have mis-identified which S1 to pair with the primary S2. Therefore we cut this event. If it fails the S2Width cut the event is not removed. Current version is developed on calibration data (pax v6.8.0). It is described in this note: https://xecluster.lngs.infn.it/dokuwiki/doku.php?id=xenon:xenon1t:jacques:s1_single_scatter_cut_sr1 It should be applicable to data regardless whether it is ER or NR. Contact: Jacques Pienaar, <jpienaar@uchicago.edu> ported from lax.sciencerun1.py

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_s1_single_scatter	bool	S1 Single Scatter cut

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

cut_s2_area_fraction_top

Description

Provided by plugin: S2AreaFractionTop

Data kind: events

Cuts events with an unusual fraction of S2 on top array.

Primarily cuts gas events with a particularly large S2 AFT, also targets some strange / junk / other events with a low AFT. This cut has been checked on S2 ranges between 0 and 50 000 pe. Described in the note at: xenon:xenon1t:analysis:firstresults:s2_aft_cut_summary Contact: Adam Brown <abrown@physik.uzh.ch>, ported from lax.sciencerun1.py

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_s2_area_fraction_top	bool	Cut on S2 AFT

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

cut_s2_single_scatter

Description

Provided by plugin: S2SingleScatter

Data kind: events

Check that largest other S2 area is smaller than some bound.

The single scatter is to cut an event if its largest_other_s2 is too large. As the largest_other_s2 takes a greater value when they originated from some real scatters in comparison, those from photo-ionization in single scatter cases would be smaller. https://xecluster.lngs.infn.it/dokuwiki/doku.php?id=xenon:xenon1t:analysis:firstresults:cut:s2single Contact: Tianyu Zhu <tz2263@columbia.edu> ported from lax.sciencerun1.py

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_s2_single_scatter	bool	S2 Single Scatter cut

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

cut_s2_threshold

Description

Provided by plugin: S2Threshold

Data kind: events

The S2 energy at which the trigger is perfectly efficient.

See: https://xecluster.lngs.infn.it/dokuwiki/doku.php?id=xenon:xenon1t:analysis:firstresults:daqtriggerpaxefficiency # noqa Contact: Jelle Aalbers <aalbers@nikhef.nl> ported from lax.sciencerun1.py

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_s2_threshold	bool	s2 must be larger then 200 PE

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

cut_s2_width

Description

Provided by plugin: S2Width

Data kind: events

S2 Width cut based on diffusion model The S2 width cut compares the S2 width to what we could

expect based on its depth in the detector.

The inputs to this are the drift velocity and the diffusion constant. The allowed variation in S2 width is greater at low energy (since it is fluctuating statistically) Ref: (arXiv:1102.2865) It should be applicable to data regardless of if it ER or NR; above cS2 = 1e5 pe ERs the acceptance will go down due to track length effects. around S2 = 1e5 pe there are beta-gamma merged peaks from Pb214 that extends the S2 width Tune the diffusion model parameters based on fax data according to note: https://xe1t-wiki.lngs.infn.it/doku.php?id=xenon:xenon1t:sim:notes:tzhu:width_cut_tuning#toy_fax_simulation Contact: Tianyu <tz2263@columbia.edu>, Yuehuan <weiyh@physik.uzh.ch>, Jelle <jaalbers@nikhef.nl> ported from lax.sciencerun1.py

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_s2_width	bool	S2 Width cut

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

event_info

Description

Provided by plugin: EventInfo1T

Data kind: events

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

This only uses 1T data-types as several event-plugins are nT only

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cs1	float32	Corrected area of main S1 [PE]
cs1_wo_timecorr	float32	Corrected area of main S1 (before LY correction) [PE]
cs2_wo_timecorr	float32	Corrected area of main S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
cs2_area_fraction_top_wo_timecorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before SEG/EE + photon ionization, after S2 xy + elife)
cs2_wo_picorr	float32	Corrected area of main S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
cs2_area_fraction_top_wo_picorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before photon ionization + elife, after S2 xy + SEG/EE)
cs2_wo_elifecorr	float32	Corrected area of main S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
cs2_area_fraction_top_wo_elifecorr	float32	Fraction of area seen by the top PMT array for corrected main S2 (before elife, after S2 xy + SEG/EE + photon ionization)
cs2	float32	Corrected area of main S2 [PE]
cs2_area_fraction_top	float32	Fraction of area seen by the top PMT array for corrected main S2
alt_cs1	float32	Corrected area of alternate S1 [PE]
alt_cs1_wo_timecorr	float32	Corrected area of alternate S1 (before LY correction) [PE]
alt_cs2_wo_timecorr	float32	Corrected area of alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife) [PE]
alt_cs2_area_fraction_top_wo_timecorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before SEG/EE + photon ionization, after S2 xy + elife)
alt_cs2_wo_picorr	float32	Corrected area of alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE) [PE]
alt_cs2_area_fraction_top_wo_picorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before photon ionization + elife, after S2 xy + SEG/EE)
alt_cs2_wo_elifecorr	float32	Corrected area of alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization) [PE]
alt_cs2_area_fraction_top_wo_elifecorr	float32	Fraction of area seen by the top PMT array for corrected alternate S2 (before elife, after S2 xy + SEG/EE + photon ionization)
alt_cs2	float32	Corrected area of alternate S2 [PE]
alt_cs2_area_fraction_top	float32	Fraction of area seen by the top PMT array for corrected alternate S2
e_light	float32	Energy in light signal [keVee]
e_charge	float32	Energy in charge signal [keVee]
e_ces	float32	Energy estimate [keVee]
n_peaks	int32	Number of peaks in the event
drift_time	float32	Drift time between main S1 and S2 in ns
event_number	int64	Event number in this dataset
s1_index	int32	Main S1 peak index in event
alt_s1_index	int32	Alternate S1 peak index in event
s1_time	int64	Main S1 start time since unix epoch [ns]
alt_s1_time	int64	Alternate S1 start time since unix epoch [ns]
s1_center_time	int64	Main S1 weighted center time since unix epoch [ns]
alt_s1_center_time	int64	Alternate S1 weighted center time since unix epoch [ns]
s1_endtime	int64	Main S1 end time since unix epoch [ns]
alt_s1_endtime	int64	Alternate S1 end time since unix epoch [ns]
s1_area	float32	Main S1 area, uncorrected [PE]
alt_s1_area	float32	Alternate S1 area, uncorrected [PE]
s1_n_channels	int16	Main S1 count of contributing PMTs
alt_s1_n_channels	int16	Alternate S1 count of contributing PMTs
s1_n_hits	int16	Main S1 count of hits contributing at least one sample to the peak
alt_s1_n_hits	int16	Alternate S1 count of hits contributing at least one sample to the peak
s1_n_competing	int32	Main S1 number of competing peaks
alt_s1_n_competing	int32	Alternate S1 number of competing peaks
s1_max_pmt	int16	Main S1 PMT number which contributes the most PE
alt_s1_max_pmt	int16	Alternate S1 PMT number which contributes the most PE
s1_max_pmt_area	float32	Main S1 area in the largest-contributing PMT (PE)
alt_s1_max_pmt_area	float32	Alternate S1 area in the largest-contributing PMT (PE)
s1_range_50p_area	float32	Main S1 width, 50% area [ns]
alt_s1_range_50p_area	float32	Alternate S1 width, 50% area [ns]
s1_range_90p_area	float32	Main S1 width, 90% area [ns]
alt_s1_range_90p_area	float32	Alternate S1 width, 90% area [ns]
s1_rise_time	float32	Main S1 time between 10% and 50% area quantiles [ns]
alt_s1_rise_time	float32	Alternate S1 time between 10% and 50% area quantiles [ns]
s1_area_fraction_top	float32	Main S1 fraction of area seen by the top PMT array
alt_s1_area_fraction_top	float32	Alternate S1 fraction of area seen by the top PMT array
s1_tight_coincidence	int16	Main S1 Channel within tight range of mean
alt_s1_tight_coincidence	int16	Alternate S1 Channel within tight range of mean
s1_n_saturated_channels	int16	Main S1 Total number of saturated channels
alt_s1_n_saturated_channels	int16	Alternate S1 Total number of saturated channels
alt_s1_interaction_drift_time	float32	Drift time using alternate S1 [ns]
alt_s1_delay	int32	Time between main and alternate S1 [ns]
s2_index	int32	Main S2 peak index in event
alt_s2_index	int32	Alternate S2 peak index in event
s2_time	int64	Main S2 start time since unix epoch [ns]
alt_s2_time	int64	Alternate S2 start time since unix epoch [ns]
s2_center_time	int64	Main S2 weighted center time since unix epoch [ns]
alt_s2_center_time	int64	Alternate S2 weighted center time since unix epoch [ns]
s2_endtime	int64	Main S2 end time since unix epoch [ns]
alt_s2_endtime	int64	Alternate S2 end time since unix epoch [ns]
s2_area	float32	Main S2 area, uncorrected [PE]
alt_s2_area	float32	Alternate S2 area, uncorrected [PE]
s2_n_channels	int16	Main S2 count of contributing PMTs
alt_s2_n_channels	int16	Alternate S2 count of contributing PMTs
s2_n_hits	int16	Main S2 count of hits contributing at least one sample to the peak
alt_s2_n_hits	int16	Alternate S2 count of hits contributing at least one sample to the peak
s2_n_competing	int32	Main S2 number of competing peaks
alt_s2_n_competing	int32	Alternate S2 number of competing peaks
s2_max_pmt	int16	Main S2 PMT number which contributes the most PE
alt_s2_max_pmt	int16	Alternate S2 PMT number which contributes the most PE
s2_max_pmt_area	float32	Main S2 area in the largest-contributing PMT (PE)
alt_s2_max_pmt_area	float32	Alternate S2 area in the largest-contributing PMT (PE)
s2_range_50p_area	float32	Main S2 width, 50% area [ns]
alt_s2_range_50p_area	float32	Alternate S2 width, 50% area [ns]
s2_range_90p_area	float32	Main S2 width, 90% area [ns]
alt_s2_range_90p_area	float32	Alternate S2 width, 90% area [ns]
s2_rise_time	float32	Main S2 time between 10% and 50% area quantiles [ns]
alt_s2_rise_time	float32	Alternate S2 time between 10% and 50% area quantiles [ns]
s2_area_fraction_top	float32	Main S2 fraction of area seen by the top PMT array
alt_s2_area_fraction_top	float32	Alternate S2 fraction of area seen by the top PMT array
s2_tight_coincidence	int16	Main S2 Channel within tight range of mean
alt_s2_tight_coincidence	int16	Alternate S2 Channel within tight range of mean
s2_n_saturated_channels	int16	Main S2 Total number of saturated channels
alt_s2_n_saturated_channels	int16	Alternate S2 Total number of saturated channels
alt_s2_interaction_drift_time	float32	Drift time using alternate S2 [ns]
alt_s2_delay	int32	Time between main and alternate S2 [ns]
s1_max_diff	int32	Main S1 largest time difference between apexes of hits [ns]
alt_s1_max_diff	int32	Alternate S1 largest time difference between apexes of hits [ns]
s1_min_diff	int32	Main S1 smallest time difference between apexes of hits [ns]
alt_s1_min_diff	int32	Alternate S1 smallest time difference between apexes of hits [ns]
s2_x	float32	Main S2 reconstructed X position, uncorrected [cm]
s2_y	float32	Main S2 reconstructed Y position, uncorrected [cm]
alt_s2_x	float32	Alternate S2 reconstructed X position, uncorrected [cm]
alt_s2_y	float32	Alternate S2 reconstructed Y position, uncorrected [cm]
area_before_main_s2	float32	Sum of areas before Main S2 [PE]
large_s2_before_main_s2	float32	The largest S2 before the Main S2 [PE]
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

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

---

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

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

---

cut_s1_low_energy_range

Description

Provided by plugin: S1LowEnergyRange

Data kind: events

Pass only events with cs1<200.

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_s1_low_energy_range	bool	Event under 200pe

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

corrected_areas

Description

Provided by plugin: CorrectedAreas

Data kind: events

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

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

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

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
avg_se_gain	cmt://avg_...gin.run_id	28.2	Nominal single electron (SE) gain in PE / electron extracted. Data will be corrected to this value
cs2_bottom_top_ratio_correction	1	<OMITTED>	Scaling factor for cS2 AFT correction due to photon ionization
default_reconstruction_algorithm	mlp	<OMITTED>	default reconstruction algorithm that provides (x,y)
elife	cmt://elif...gin.run_id	1000000.0	electron lifetime in [ns]
region_circular	60	<OMITTED>	circular cut (cm) for ab region, check out the note https://xe1t-wiki.lngs.infn.it/doku.php?id=jlong:sr0_2_region_se_correction
region_linear	28	<OMITTED>	linear cut (cm) for ab region, check out the note https://xe1t-wiki.lngs.infn.it/doku.php?id=jlong:sr0_2_region_se_correction
rel_extraction_eff	cmt://rel_...gin.run_id	1.0	Relative extraction efficiency for this run (allows for time dependence)
rel_light_yield	cmt://rela...gin.run_id	1.0	Relative light yield (allows for time dependence)
s1_xyz_map	itp_map://..._algorithm	itp_map://resource://https://raw.githubusercontent.com/XENON1T/pax/master/pax/data/XENON1T_s1_xyz_lce_true_kr83m_SR1_pax-680_fdc-3d_v0.json?fmt=json
s2_xy_map	itp_map://..._algorithm	itp_map://resource://https://raw.githubusercontent.com/XENON1T/pax/master/pax/data/XENON1T_s2_xy_ly_SR1_v2.2.json?fmt=json
se_gain	cmt://se_g...gin.run_id	28.2	Actual SE gain for a given run (allows for time dependence)

---

cut_fiducial_cylinder_1t

Description

Provided by plugin: FiducialCylinder1T

Data kind: events

Implementation of fiducial volume cylinder 1T, ported from lax.sciencerun0.py.

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]
cut_fiducial_cylinder_1t	bool	One tonne fiducial cylinder

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

event_positions

Description

Provided by plugin: EventPositions

Data kind: events

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

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

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
default_reconstruction_algorithm	mlp	<OMITTED>	default reconstruction algorithm that provides (x,y)
electron_drift_time_gate	cmt://elec...gin.run_id	1700	Electron drift time from the gate in ns
electron_drift_velocity	cmt://elec...gin.run_id	0.000133	Vertical electron drift velocity in cm/ns (1e4 m/ms)
fdc_map	legacy-fdc...gin.run_id	<OMITTED>	3D field distortion correction map path
z_bias_map	legacy-z_bias://0	<OMITTED>	Map of Z bias due to non uniform drift velocity/field

---

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

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

---

cut_s1_max_pmt

Description

Provided by plugin: S1MaxPMT

Data kind: events

Removes events where the largest hit in S1 is too large port from lax.sciencerun0.py.

Columns provided

Field name	Data type	Comment
cut_s1_max_pmt	bool	S1 max PMT cut
time	int64	Start time since unix epoch [ns]
endtime	int64	Exclusive end time since unix epoch [ns]

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help

---

event_basics

Description

Provided by plugin: EventBasics

Data kind: events

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

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

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
allow_posts2_s1s	False	<OMITTED>	Allow S1s past the main S2 to become the main S1 and S2
electron_drift_velocity	cmt://elec...gin.run_id	0.000133	Vertical electron drift velocity in cm/ns (1e4 m/ms)
event_s1_min_coincidence	2	3	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	96.9	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_competing” peaks. (A competing peak must have a certain area fraction of the triggering peak and must be in a window close to the main peak)

Note:

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

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

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

---

peak_proximity

Description

Provided by plugin: PeakProximity

Data kind: peaks

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

peak.

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

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

---

peak_basics

Description

Provided by plugin: PeakBasics

Data kind: peaks

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

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

Columns provided

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

Dependencies

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

---

peak_positions

Description

Provided by plugin: PeakPositions1T

Data kind: peaks

Compute the S2 (x,y)-position based on a neural net.

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
min_reconstruction_area	10	<OMITTED>	Skip reconstruction if area (PE) is less than this
n_top_pmts	253	127	Number of top PMTs
nn_architecture	https://ra...atted.json	<OMITTED>	Path to JSON of neural net architecture
nn_weights	https://ra...217_sr1.h5	<OMITTED>	Path to HDF5 of neural net weights

---

peaks

Description

Provided by plugin: Peaks

Data kind: peaks

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

later re-merged as S2s).

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

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
diagnose_sorting	False	<OMITTED>	Enable runtime checks for sorting and disjointness
merge_without_s1	True	<OMITTED>	If true, S1s will be igored during the merging. It's now possible for a S1 to be inside a S2 post merging

---

merged_s2s

Description

Provided by plugin: MergedS2s

Data kind: merged_s2s

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

instead.

Columns provided

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

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

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

---

peaklet_classification

Description

Provided by plugin: PeakletClassification

Data kind: peaklets

Classify peaklets as unknown, S1, or S2.

Columns provided

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

Dependencies

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	127	Number of top PMTs
s1_flatten_threshold_aft	(0.6, 100)	<OMITTED>	Threshold for AFT, above which we use a flatted boundary for rise timeSpecified values: (AFT boundary, constant rise time).
s1_max_rise_time_post100	200	150	Maximum S1 rise time for > 100 PE [ns]
s1_min_coincidence	2	3	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

---

peaklets

Description

Provided by plugin: Peaklets

Data kind: peaklets

Split records into:

• peaklets

• lone_hits

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

To get Peaklets from records apply/do:

1. Hit finding

2. Peak finding

3. Peak splitting using the natural breaks algorithm

4. Compute the digital sum waveform

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

Columns provided

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

Dependencies

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, diagnostic, aqmon)	immutabledict mapping subdetector to (min, max) channel number.
diagnose_sorting	False	<OMITTED>	Enable runtime checks for sorting and disjointness
gain_model	<OMITTED>	cmt://to_pe_model?version=v1&detector=1t&run_id=plugin.run_id	PMT gain model. Specify as URL or explicit value
hit_min_amplitude	cmt://hit_...gin.run_id	legacy-thresholds://XENON1T_SR1	Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
n_top_pmts	<OMITTED>	127	Number of top TPC array PMTs
n_tpc_pmts	<OMITTED>	248	Number of TPC PMTs
peak_left_extension	30	<OMITTED>	Include this many ns left of hits in peaks
peak_min_pmts	2	2	Minimum number of contributing PMTs needed to define a peak
peak_right_extension	200	30	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)))	(None, ((0.5, 1), (3.5, 0.25)), ((2, 1), (4.5, 0.4)))	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	350	No hits for this many ns triggers a new peak
peaklet_max_duration	10000000	<OMITTED>	Maximum duration [ns] of a peaklet
saturation_correction_on	True	<OMITTED>	On off switch for saturation correction
saturation_min_reference_length	20	<OMITTED>	Minimum number of reference sample used to correct saturated samples
saturation_reference_length	100	<OMITTED>	Maximum number of reference sample used to correct saturated samples
sum_waveform_top_array	True	<OMITTED>	Digitize the sum waveform of the top array separately
tight_coincidence_window_left	50	<OMITTED>	Time range left of peak center to call a hit a tight coincidence (ns)
tight_coincidence_window_right	50	<OMITTED>	Time range right of peak center to call a hit a tight coincidence (ns)

---

lone_hits

Description

Provided by plugin: Peaklets

Data kind: lone_hits

Split records into:

• peaklets

• lone_hits

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

To get Peaklets from records apply/do:

1. Hit finding

2. Peak finding

3. Peak splitting using the natural breaks algorithm

4. Compute the digital sum waveform

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

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
length	int32	Length of the interval in samples
dt	int16	Width of one sample [ns]
channel	int16	Channel/PMT number
area	float32	Integral [ADC x samples]
left	int16	Index of sample in record in which hit starts
right	int16	Index of first sample in record just beyond hit (exclusive bound)
left_integration	int16	For lone hits, index of sample in record where integration starts
right_integration	int16	For lone hits, index of first sample beyond integration region
record_i	int32	Internal (temporary) index of fragment in which hit was found
threshold	float32	ADC threshold applied in order to find hits
height	float32	Maximum amplitude above baseline [ADC counts]

Dependencies

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, diagnostic, aqmon)	immutabledict mapping subdetector to (min, max) channel number.
diagnose_sorting	False	<OMITTED>	Enable runtime checks for sorting and disjointness
gain_model	<OMITTED>	cmt://to_pe_model?version=v1&detector=1t&run_id=plugin.run_id	PMT gain model. Specify as URL or explicit value
hit_min_amplitude	cmt://hit_...gin.run_id	legacy-thresholds://XENON1T_SR1	Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
n_top_pmts	<OMITTED>	127	Number of top TPC array PMTs
n_tpc_pmts	<OMITTED>	248	Number of TPC PMTs
peak_left_extension	30	<OMITTED>	Include this many ns left of hits in peaks
peak_min_pmts	2	2	Minimum number of contributing PMTs needed to define a peak
peak_right_extension	200	30	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)))	(None, ((0.5, 1), (3.5, 0.25)), ((2, 1), (4.5, 0.4)))	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	350	No hits for this many ns triggers a new peak
peaklet_max_duration	10000000	<OMITTED>	Maximum duration [ns] of a peaklet
saturation_correction_on	True	<OMITTED>	On off switch for saturation correction
saturation_min_reference_length	20	<OMITTED>	Minimum number of reference sample used to correct saturated samples
saturation_reference_length	100	<OMITTED>	Maximum number of reference sample used to correct saturated samples
sum_waveform_top_array	True	<OMITTED>	Digitize the sum waveform of the top array separately
tight_coincidence_window_left	50	<OMITTED>	Time range left of peak center to call a hit a tight coincidence (ns)
tight_coincidence_window_right	50	<OMITTED>	Time range right of peak center to call a hit a tight coincidence (ns)

---

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

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	True	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	False	Crash if any of the pulses in raw_records overlap with others in the same channel
events_per_chunk	50	<OMITTED>	Number of events to yield per chunk
hev_gain_model	None	cmt://to_pe_model?version=v1&detector=1t&run_id=plugin.run_id	PMT gain model used in the software high-energy veto.
hit_min_amplitude	cmt://hit_...gin.run_id	legacy-thresholds://XENON1T_SR1	Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
max_veto_value	None	<OMITTED>	Optionally pass a HE peak that exceeds this absolute area. (if performing a hard veto, can keep a few statistics.)
n_tpc_pmts	<OMITTED>	248	Number of TPC PMTs
pax_raw_dir	/data/xenon/raw	<OMITTED>	Directory with raw pax datasets
pmt_pulse_filter	None	(0.012, -0.119, 2.435, -1.271, 0.357, -0.174, -0.0, -0.036, -0.028, -0.019, -0.025, -0.013, -0.03, -0.039, -0.005, -0.019, -0.012, -0.015, -0.029, 0.024, -0.007, 0.007, -0.001, 0.005, -0.002, 0.004, -0.002)	Linear filter to apply to pulses, will be normalized.
samples_per_record	110	<OMITTED>	Number of samples per record
save_outside_hits	(3, 20)	(3, 3)	Save (left, right) samples besides hits; cut the rest
stop_after_zips	0	<OMITTED>	Convert only this many zip files. 0 = all.
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	100000	Minimum peakarea in PE to trigger tail veto.Set to None, 0 or False to disable veto.

---

veto_regions

Description

Provided by plugin: PulseProcessing

Data kind: veto_regions

Split raw_records into:

• (tpc) records

• aqmon_records

• pulse_counts

For TPC records, apply basic processing:

1. Flip, baseline, and integrate the waveform

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

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

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

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
length	int32	Length of the interval in samples
dt	int16	Width of one sample [ns]
channel	int16	Channel/PMT number
area	float32	Integral [ADC x samples]
left	int16	Index of sample in record in which hit starts
right	int16	Index of first sample in record just beyond hit (exclusive bound)
left_integration	int16	For lone hits, index of sample in record where integration starts
right_integration	int16	For lone hits, index of first sample beyond integration region
record_i	int32	Internal (temporary) index of fragment in which hit was found
threshold	float32	ADC threshold applied in order to find hits
height	float32	Maximum amplitude above baseline [ADC counts]

Dependencies

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	True	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	False	Crash if any of the pulses in raw_records overlap with others in the same channel
hev_gain_model	None	cmt://to_pe_model?version=v1&detector=1t&run_id=plugin.run_id	PMT gain model used in the software high-energy veto.
hit_min_amplitude	cmt://hit_...gin.run_id	legacy-thresholds://XENON1T_SR1	Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
max_veto_value	None	<OMITTED>	Optionally pass a HE peak that exceeds this absolute area. (if performing a hard veto, can keep a few statistics.)
n_tpc_pmts	<OMITTED>	248	Number of TPC PMTs
pmt_pulse_filter	None	(0.012, -0.119, 2.435, -1.271, 0.357, -0.174, -0.0, -0.036, -0.028, -0.019, -0.025, -0.013, -0.03, -0.039, -0.005, -0.019, -0.012, -0.015, -0.029, 0.024, -0.007, 0.007, -0.001, 0.005, -0.002, 0.004, -0.002)	Linear filter to apply to pulses, will be normalized.
save_outside_hits	(3, 20)	(3, 3)	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	100000	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', (248,))	Number of pulses
lone_pulse_count	('<i8', (248,))	Number of lone pulses
pulse_area	('<i8', (248,))	Integral of all pulses in ADC_count x samples
lone_pulse_area	('<i8', (248,))	Integral of lone pulses in ADC_count x samples
baseline_mean	('<i2', (248,))	Average baseline
baseline_rms_mean	('<f4', (248,))	Average baseline rms

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
allow_sloppy_chunking	False	True	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	False	Crash if any of the pulses in raw_records overlap with others in the same channel
hev_gain_model	None	cmt://to_pe_model?version=v1&detector=1t&run_id=plugin.run_id	PMT gain model used in the software high-energy veto.
hit_min_amplitude	cmt://hit_...gin.run_id	legacy-thresholds://XENON1T_SR1	Minimum hit amplitude in ADC counts above baseline. Specify as a tuple of length n_tpc_pmts, or a number,or a string like "pmt_commissioning_initial" which means callinghitfinder_thresholds.pyor a tuple like (correction=str, version=str, nT=boolean),which means we are using cmt.
max_veto_value	None	<OMITTED>	Optionally pass a HE peak that exceeds this absolute area. (if performing a hard veto, can keep a few statistics.)
n_tpc_pmts	<OMITTED>	248	Number of TPC PMTs
pmt_pulse_filter	None	(0.012, -0.119, 2.435, -1.271, 0.357, -0.174, -0.0, -0.036, -0.028, -0.019, -0.025, -0.013, -0.03, -0.039, -0.005, -0.019, -0.012, -0.015, -0.029, 0.024, -0.007, 0.007, -0.001, 0.005, -0.002, 0.004, -0.002)	Linear filter to apply to pulses, will be normalized.
save_outside_hits	(3, 20)	(3, 3)	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	100000	Minimum peakarea in PE to trigger tail veto.Set to None, 0 or False to disable veto.

---

raw_records

Description

Provided by plugin: RecordsFromPax

Data kind: raw_records

(no plugin description)

Columns provided

Field name	Data type	Comment
time	int64	Start time since unix epoch [ns]
length	int32	Length of the interval in samples
dt	int16	Width of one sample [ns]
channel	int16	Channel/PMT number
pulse_length	int32	Length of pulse to which the record belongs (without zero-padding)
record_i	int16	Fragment number in the pulse
baseline	int16	Baseline determined by the digitizer (if this is supported)
data	('<i2', (110,))	Waveform data in raw ADC counts

Dependencies

Configuration options

These are all options that affect this data type. This also includes options taken by dependencies of this datatype, because changing any of those options affect this data indirectly.

option	default	current	help
events_per_chunk	50	<OMITTED>	Number of events to yield per chunk
pax_raw_dir	/data/xenon/raw	<OMITTED>	Directory with raw pax datasets
samples_per_record	110	<OMITTED>	Number of samples per record
stop_after_zips	0	<OMITTED>	Convert only this many zip files. 0 = all.

---