SNGenbb Manager Configuration

1. Introduction
2. Manager configuration
3. Genbb wrappers

1 Introduction

The genbb package is dedicated to the generation of double beta decay and/or radioactive background primary events as input for a simulation program.

More details concerning the use of genbb can be found in LPC wiki.

2 Manager configuration

Here, general options such as verbosity, debug flags are passed to genbb manager.

#@config Main configuration parameters for the genbb manager

#@description Logging priority
logging.priority : string = @variant(core:logging_priority|"warning")

#@description List of files containing particle generator definition rules
generators.configuration_files : string[5] as path = \
    "@falaise:config/common/simulation/primary_events/1.0/background.def"  \
    "@falaise:config/common/simulation/primary_events/1.0/calibration.def" \
    "@falaise:config/common/simulation/primary_events/1.0/dbd.def"         \
    "@falaise:config/common/simulation/primary_events/1.0/misc.def"        \
    "@configuration:sngenbb_wrappers.conf"

3 Genbb wrappers

This section holds the configuration of several genbb wrappers.

#@description A sample list of setups
#@key_label   "name"
#@meta_label  "type"

3.1 2ν2β isotope with energy cut

[name="Se82.2nubb-2MeV" type="genbb::wdecay0"]
#@config Two neutrino double beta decay of Se-82, 2nubb [DBD]
decay_type      : string  = "DBD"
decay_isotope   : string  = "Se82"
decay_dbd_level : integer = 0
decay_dbd_mode  : integer = 4
energy_min      : real as energy = 2.0 MeV

3.2 ⁹⁶Zr excited state

[name="Zr96.2nubb" type="genbb::wdecay0"]
#@config Two neutrino double beta decay of Zr-96, 2nubb [DBD]
decay_type      : string  = "DBD"
decay_isotope   : string  = "Zr96"
decay_dbd_level : integer = 2
decay_dbd_mode  : integer = 4 # 2nubb

3.3 ²²²Rn in the tracking chamber

Here, we use the same definition as Bi214_Po214 that can be find in @falaise:config/common/simulation/primary_events/1.0/background.def. We just change the genbb label to distinguish the ²¹⁴Bi events generated in the source foil to the ones generated in the tracking chamber.

[name="Rn222" type="genbb::wdecay0"]
#@config Bi-214/Po-214 decay in the tracker [background]
decay_type      : string  = "background"
decay_isotope   : string  = "Bi214+Po214"

3.4 Radioelement wrappers

This part basically provides additionnal event generator wrappers for SuperNEMO.

3.4.1 ²¹⁴Pb 0νββ

Following a talk given by Vladimir Treytak during Bratislava collaboration meeting, 2013, ²¹⁴Pb is also a 2β emitter

[name="Pb214.0nubb" type="genbb::wdecay0"]
#@config Neutrinoless double beta decay of Pb-214 [DBD]
decay_type      : string  = "DBD"
decay_isotope   : string  = "Pb214"
decay_dbd_level : integer = 0
decay_dbd_mode  : integer = 1

3.5 Single particle generators

Here, single particle can be generated using different energy distribution : fix energy, flat energy distribution given energy limits, gaussian energy distribution or following a tabulated energy spectrum.

3.5.1 Single monokinetic electron

[name="electron_monokinetic" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "electron"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "monokinetic"

#@description Value of the particle energy
energy : real as energy = 1000. keV

#@description Flag for random emission
emission_direction : string = "randomized"

3.5.2 Single electron with flat energy distribution

[name="electron_0-3MeV_flat" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "electron"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "energy_range"

#@description Minimal energy value
min_energy : real as energy =    0. keV

#@description Maximal energy value
max_energy : real as energy = 3000. keV

#@description Flag for random emission
emission_direction : string = "randomized"

3.5.3 Single electron with gaussian energy distribution

[name="electron_gaussian_energy" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "electron"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "energy_range"

#@description Mean energy for the gaussian distribution
mean_energy : real as energy = 1000. keV

#@description Sigma value for the gaussian distribution
sigma_energy : real as energy =  100. keV

#@description Flag for random emission
emission_direction : string = "randomized"

3.5.4 Single electron with conic emission

[name="electron_monokinetic_with_cone" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "electron"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "monokinetic"

#@description Direction of the emitted particle
emission_direction : string = "cone"

#@description The emission cone axis (values: "+x", "-x", "+y", "-y", "+z", "-z", "30.0 45.0 degree")
cone.axis : string = "-z"

#@description The default implicit angle unit
angle_unit : string = "degree"

#@description The minimum emission angle (cone)
cone.min_angle : real as angle = 0 degree

#@description The maximum emission angle (cone)
cone.max_angle : real as angle = 10 degree

#@description The kinetic energy of the generated particle
energy : real as energy = 3000 keV

3.5.5 Single gamma with monokinetic energy

[name="gamma_monokinetic" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "gamma"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "monokinetic"

#@description Value of the particle energy
energy : real as energy = 500. keV

#@description Flag for random emission
emission_direction : string = "randomized"

3.5.6 Single gamma with flat energy distribution

[name="gamma_0-3MeV_flat" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "gamma"

#@description Flag for random emission
emission_direction : string = "randomized"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "energy_range"

#@description Minimal value of the particle energy
min_energy : real as energy = 0. MeV

#@description Maximal value of the particle energy
max_energy : real as energy = 3. MeV

3.5.7 Multi-γ-rays

[name="multi_gamma_rays" type="genbb::single_particle_generator"]

#@config Parameters for the generation of multiple gamma rays

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "gamma"

#@description Flag for random emission
emission_direction : string = "randomized"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "multi_rays"

#@description Energy unit
energy_unit : string = "keV"

#@description Particle energies
multi_rays.energies : real[9] in keV = 53.161 79.6139 80.9971 160.613 223.234 276.398 302.853 356.017 383.851

#@description Particle relative probabilities
multi_rays.probabilities : real[9] = 0.02199 0.0262 0.0406 0.00645 0.00450 0.07164 0.1833 0.6205 0.0894

3.5.8 Single monokinetic alpha

[name="alpha_monokinetic" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "alpha"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "monokinetic"

#@description Value of the particle energy
energy : real as energy = 7000. keV

#@description Flag for random emission
emission_direction : string = "randomized"

3.6 Combined generators

Combination of several genbb generators can be done using genbb::combined_particle_generator object…

3.6.1 Simultaneous γ-rays

[name="multi_gamma_particles" type="genbb::combined_particle_generator"]

#@config A model that generates several particles  at the same time

#@description Logging priority
logging.priority : string = @variant(core:logging_priority|"warning")

#@description Assign unique generation id
assign_generation_ids : boolean = true

#@description The mode ("timing", "plain_probability" or "activity")
mode : string = "time"

#@description The list of particle generators that compose the combo
generators.labels : string[3] = \
                  "gamma1"      \
                  "gamma1"      \
                  "gamma1"

#@description The name of the generator associated the "gamma1" contribution
generators.gamma1.name : string = "gamma_monokinetic"

#@description The time mode associated to the "gamma1" contribution
generators.gamma1.time_mode : string = "fixed"

#@description The shift time associated to the "gamma1" contribution
generators.gamma1.fixed_time : real as time = 0 ns

#@description The name of the generator associated the "gamma2" contribution
generators.gamma2.name : string = "gamma_monokinetic"

#@description The time mode associated to the "gamma2" contribution
generators.gamma2.time_mode : string = "fixed"

#@description The shift time associated to the "gamma2" contribution
generators.gamma2.fixed_time : real as time = 0 ns

3.6.2 Multi-particles gun

[name="electron_monokinetic1" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "electron"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "monokinetic"

#@description Value of the particle energy
energy : real as energy = 1000. keV

#@description Flag for random emission
emission_direction : string = "randomized"

[name="electron_monokinetic2" type="genbb::single_particle_generator"]

#@config Parameters for the 'single_particle' mode (class genbb::single_particle_generator):

#@description Generated particle ("electron", "positron", "gamma", "alpha"):
particle_name : string = "electron"

#@description Mode ("energy_range", "gaussian_energy", "monokinetic", "spectrum"):
mode : string = "monokinetic"

#@description Value of the particle energy
energy : real as energy = 3000. keV

#@description Flag for random emission
emission_direction : string = "randomized"

[name="multi_particles" type="genbb::combined_particle_generator"]

#@config A model that generates several particles  at the same time

#@description Logging priority
logging.priority : string = @variant(core:logging_priority|"warning")

#@description Assign unique generation id
assign_generation_ids : boolean = true

#@description The mode ("timing", "plain_probability" or "activity")
mode : string = "time"

#@description The list of particle generators that compose the combo
generators.labels : string[3] = \
                  "electron1"   \
                  "electron2"   \
                  "gamma1"

#@description The name of the generator associated the "electron1" contribution
generators.electron1.name : string = "electron_monokinetic1"

#@description The time mode associated to the "electron1" contribution
generators.electron1.time_mode : string = "fixed"

#@description The shift time associated to the "electron1" contribution
generators.electron1.fixed_time : real as time = 0 ns

#@description The name of the generator associated the "electron2" contribution
generators.electron2.name : string = "electron_monokinetic1"

#@description The time mode associated to the "electron2" contribution
generators.electron2.time_mode : string = "fixed"

#@description The shift time associated to the "electron2" contribution
generators.electron2.fixed_time : real as time = 0 ns

#@description The name of the generator associated the "gamma1" contribution
generators.gamma1.name : string = "gamma_monokinetic"

#@description The time mode associated to the "electron2" contribution
generators.gamma1.time_mode : string = "fixed"

#@description The shift time associated to the "electron2" contribution
generators.gamma1.fixed_time : real as time = 0 ns