SHOE Reconstruction software (of the FOOT experiment)

Architecture of the SHOE-Reconstuction code

The part of SHOE dedicated to the event reconstracion is divided in 3 parts:

1. Libraries of general interest, containing the main classes used by the reconstruction (and in part by the generation) code. The GenFit external libraries are also here.
2. Level0 reconstruction code that is in charge of the interpretation of both MC and acquired data, digitization, alignment and clustering of the events and the track reconstruction.
3. HighLevel reconstruction that is in charge of the fragment identification and of the cross section measurement.

A breaf scheme of SHOE-reco follows.

Running SHOE

Getting the code

The instructions on how to get the code can be found in the sotfware page.

Environment setup

Every time you enter in your machine, you have to setup the SHOE environment doing.

Starting from where you installed the software.

cd shoe/build
source setupFOOT.sh

Then, if you are on the tier3 or on your local laptop you can follow different instructions.

To complete the setup at the tier3 you can

source /opt/rh/devtoolset-6/enable; source /opt/exp_software/foot/root4foot.sh

Then you can check out that the libraries are properly compiled and placed inside the libs/lib folder.

Running the code using the executables

The software needs to be run under the build folder, selecting the project that you want to start with.

Before running, have a look at the global parameters defined in the global configuration file:

nano $FOOTCONFIG/FootGlobal.par

(exit with ctrl-x). You can replace nano with your favourite file editor.

Running the GSI MC reconstruction.

First of all you need to

• Setup the environment under build:
• go into the build/Reconstruction/level0

cd build/Reconstruction/level0

• Execute the following command

../../bin/DecodeMC -in filename.root -out test.root -his -ntu -trk -nev 1500  -exp GSI -hit  

This command contains a lot of 'tuning' of what you are telling shoe to do: here's an explanation of the flags and of the underlying setup.

• DecodeMC is the executable
• filename.root should be replaced with the input file you want to process
• test.root should be replaced with the output file you want to generate
• -his: produces histograms
• -ntu: fills the ntuple
• -trk: performs the track reconstruction
• -nev: process a fixed number of events
• -exp: specified the geometry and tuning for the data/MC. Configurations are loaded from config/GSI and geomaps/GSI (in this case)
• -hit: the hit information is saved into the ntuple

Running the data reconstruction

First of all you need to

• Setup the environment under build:
• go into the build/Reconstruction/level0

cd build/Reconstruction/level0

• Execute the following command

../../bin/DecodeRaw -in data.dat -out test.root  -his -ntu -trk -nev 150  -exp GSI 

This command contains a lot of 'tuning' of what you are telling shoe to do: here's an explanation of the flags and of the underlying setup.

• DecodeRaw is the executable
• data.dat should be replaced with the input file you want to process
• test.root should be replaced with the output file you want to generate
• -his: produces histograms
• -ntu: fills the ntuple
• -trk: performs the track reconstruction
• -nev: process a fixed number of events
• -exp: specified the geometry and tuning for the data/MC. Configurations are loaded from config/GSI and geomaps/GSI (in this case

Input Files

You can find the available MC samples lsted and described here.

For the data files, a description of the GSI sample can be found here.

Output Files

The SHOE-reconstuction code stores the information in an ntuple file and in ah histogram file:

DecodedMC.root
DecodeMC_histo.root

The KalmanFilter tracking info are plotter in the results folder as .root and .png files.