S2PhotonPropagation
Link to source: S2PhotonPropagation
Plugin Description
S2 photon propagation using Garfield gas-gap luminescence + optical propagation.
Technical Details
depends_on = ('merged_s2_photons', 'merged_extracted_electrons')
provides = ('propagated_s2_photons',)
data_kind = s2_photons
__version__ = 0.2.0
child_plugin = True
parent_plugin_version = 0.4.2
Provided Columns
propagated_s2_photons
Field Name |
Data Type |
Comment |
|---|---|---|
channel |
int16 |
PMT channel of the photon |
dpe |
bool |
Photon creates a double photo-electron emission |
photon_gain |
int32 |
Sampled PMT gain for the photon |
cluster_id |
int32 |
ID of the cluster creating the photon |
photon_type |
int8 |
Type of the photon. S1 (1), S2 (2) or PMT AP (0) |
time |
int64 |
Start time since unix epoch [ns] |
endtime |
int64 |
Exclusive end time since unix epoch [ns] |
Config Options
Option |
default |
track |
Help |
|---|---|---|---|
debug |
False |
False |
Show debug informations |
deterministic_seed |
True |
True |
Set the random seed from lineage and run_id, or pull the seed from the OS |
digitizer_bits |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=digitizer_bits |
True |
Number of bits of the digitizer boards |
digitizer_voltage_range |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=digitizer_voltage_range |
True |
Voltage range of the digitizer boards [V] |
field_dependencies_map_tmp |
itp_map://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=field_dependencies_map&fmt=json.gz&method=WeightedNearestNeighbors |
True |
Map for the electric field dependencies |
gain_model_mc |
list-to-array://xedocs://pmt_area_to_pes?as_list=True&sort=pmt&detector=tpc&run_id=plugin.run_id&version=ONLINE&attr=value |
True |
PMT gain model |
garfield_gas_gap_map |
itp_map://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=garfield_gas_gap_map&fmt=json |
True |
Garfield gas gap map |
min_electron_gap_length_for_splitting |
2000000.0 |
False |
Chunk can not be split if gap between photons is smaller than this value [ns] |
n_top_pmts |
<OMITTED> |
True |
Number of PMTs on top array |
n_tpc_pmts |
<OMITTED> |
True |
Number of PMTs in the TPC |
p_double_pe_emision |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=p_double_pe_emision |
True |
Probability of double photo-electron emission |
phase_s2 |
gas |
True |
Phase of the S2 producing region |
photon_area_distribution |
simple_load://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=photon_area_distribution&fmt=csv |
True |
Photon area distribution |
pmt_circuit_load_resistor |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=pmt_circuit_load_resistor |
True |
PMT circuit load resistor [kg m^2/(s^3 A)] |
pmt_transit_time_mean |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=pmt_transit_time_mean |
True |
Mean of the PMT transit times [ns] |
pmt_transit_time_spread |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=pmt_transit_time_spread |
True |
Spread of the PMT transit times [ns] |
propagated_s2_photons_file_size_target |
300 |
False |
Target for the propagated_s2_photons file size [MB] |
s2_aft_sigma |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=s2_aft_sigma |
True |
Width of the S2 area fraction top |
s2_aft_skewness |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=s2_aft_skewness |
True |
Skew of the S2 area fraction top |
s2_luminescence_map |
simple_load://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=s2_luminescence_gg&fmt=npy |
True |
Luminescence map for S2 Signals |
s2_mean_area_fraction_top |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=s2_mean_area_fraction_top |
True |
Mean S2 area fraction top |
s2_optical_propagation_spline |
itp_map://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=s2_time_spline&fmt=json.gz&method=RegularGridInterpolator |
True |
Spline for the optical propagation of S2 signals |
s2_pattern_map |
s2_aft_scaling://pattern_map://resource://simulation_config://SIMULATION_CONFIG_FILE.json?&key=s2_pattern_map&fmt=pkl&pmt_mask=plugin.pmt_mask&s2_mean_area_fraction_top=plugin.s2_mean_area_fraction_top&n_tpc_pmts=plugin.n_tpc_pmts&n_top_pmts=plugin.n_top_pmts&turned_off_pmts=plugin.turned_off_pmts&method=plugin.s2_pattern_map_interpolation_method |
True |
S2 pattern map |
s2_pattern_map_interpolation_method |
WeightedNearestNeighbors |
True |
Interpolation method for the S2 pattern map |
s2_secondary_sc_gain_mc |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=s2_secondary_sc_gain |
True |
Secondary scintillation gain [PE/e-] |
singlet_fraction_gas |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=singlet_fraction_gas |
True |
Fraction of singlet states in GXe |
singlet_lifetime_gas |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=singlet_lifetime_gas |
True |
Liftetime of singlet states in GXe [ns] |
singlet_lifetime_liquid |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=singlet_lifetime_liquid |
True |
Liftetime of singlet states in LXe [ns] |
tpc_length |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=tpc_length |
True |
Length of the XENONnT TPC [cm] |
tpc_radius |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=tpc_radius |
True |
Radius of the XENONnT TPC [cm] |
triplet_lifetime_gas |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=triplet_lifetime_gas |
True |
Liftetime of triplet states in GXe [ns] |
triplet_lifetime_liquid |
take://resource://SIMULATION_CONFIG_FILE.json?&fmt=json&take=triplet_lifetime_liquid |
True |
Liftetime of triplet states in LXe [ns] |
user_defined_random_seed |
None |
True |
Define the random seed manually. You need to set deterministic_seed to False |