SuperNEMO - Vertex reconstruction

This repository holds a SN@ilWare configuration + source code to study the vertex reconstruction of particle track in SuperNEMO. It especially produces plots of vertex position resolution on the source foil as well as on calorimeter wall surface.

The current version is hosted at https://github.com/xgarrido/snemo_simulation_modules/snemo_vertex_resolution under git version control.

The code itself is implemented in the source directory which holds the snemo_vertex_resolution_module.* source code as well as a CMakeLists.txt file in order to compile, build and install the module following cmake rules.

Module configuration

The next item holds the configuration for the module itself. The second item is related to histogram declarations.

Module declaration

The module name is vertex_resolution_module which is needed when using bxdpp_processing as explained in the top README file.

File preamble

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

Declaration & description

[name="vertex_resolution_module" type="analysis::snemo_vertex_resolution_module"]

#@description A SuperNEMO module to show the vertex position resolution

Logging priority

#@description Logging priority
logging.priority : string = "error"

Histogram service label

Set the same histogram service label as defined here

#@description The Histogram Service label
Histo_label : string = "Histo"

Histogram storage

All histograms generated by this module can be stored inside ROOT files or XML archives.

#@description The ouput file where to store the histograms
Histo_output_files : string[2] as path =                       \
    "/tmp/${USER}/snemo.d/snemo_vertex_resolution_histos.root" \
    "/tmp/${USER}/snemo.d/snemo_vertex_resolution_histos.xml"

Histogram template location

Templates for histogram may be provided to reduce the amount of configuration of individual histogram. For instance, plotting the vertex position distributions only implies 3 histogram templates for each of the 3 cartesian coordinates \(x,y,z\) (see below).

#@description The ouput file where to store the histograms
Histo_template_files : string[1] as path = \
    "@SNEMO_SIMULATION_MODULES_DIR@/snemo_vertex_resolution_histogram_templates.conf"

Histogram declarations

The histogram declarations i.e. name, boundaries, binning… are set in this section. There are mostly template histogram in such way, their declarations may be used as templates for several histograms.

Mandatory preamble

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

\(x\)-position distribution

[name="delta_x" type="mygsl::histogram_1d"]
#@config The histogram template of the x-position of vertex reconstruction

#@description The group of the histogram (optional)
group : string = "__template"

#@description The build mode (default : "regular", "table", "mimic");
mode : string = "regular"

#@description The linear mode (default)
linear : boolean = 1

#@description The X axis label
display.xaxis.label : string = "\Updelta x"

#@description The Y axis label
display.yaxis.label : string = "dN/dx"

#@description The number of bins
number_of_bins : integer = 100

#@description The unit of the bins' bounds (a standard unit, typically SI or CLHEP)
unit : string = "mm"

#@description The lower bound of the histogram
min : real as length = -50.0 mm

#@description The upper bound of the histogram
max : real as length = +50.0 mm

\(y\)-position distribution

[name="delta_y" type="mygsl::histogram_1d"]
#@config The histogram template of the y-position of vertex reconstruction

#@description The group of the histogram (optional)
group : string = "__template"

#@description The build mode (default : "regular", "table", "mimic");
mode : string = "regular"

#@description The linear mode (default)
linear : boolean = 1

#@description The X axis label
display.xaxis.label : string = "\Updelta y"

#@description The Y axis label
display.yaxis.label : string = "dN/dx"

#@description The number of bins
number_of_bins : integer = 100

#@description The unit of the bins' bounds (a standard unit, typically SI or CLHEP)
unit : string = "mm"

#@description The lower bound of the histogram
min : real as length = -50.0 mm

#@description The upper bound of the histogram
max : real as length = +50.0 mm

\(z\)-position distribution

[name="delta_z" type="mygsl::histogram_1d"]
#@config The histogram template of the x-position of vertex reconstruction

#@description The group of the histogram (optional)
group : string = "__template"

#@description The build mode (default : "regular", "table", "mimic");
mode : string = "regular"

#@description The linear mode (default)
linear : boolean = 1

#@description The X axis label
display.xaxis.label : string = "\Updelta z"

#@description The Y axis label
display.yaxis.label : string = "dN/dx"

#@description The number of bins
number_of_bins : integer = 100

#@description The unit of the bins' bounds (a standard unit, typically SI or CLHEP)
unit : string = "mm"

#@description The lower bound of the histogram
min : real as length = -50.0 mm

#@description The upper bound of the histogram
max : real as length = +50.0 mm