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:
- 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.
- 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.
- 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
source setupFOOT.sh
SHOE compilation and run
The software compilatin proceeds in 2 steps:
- GenFit compile
- SHOE libraries compilation;
- Level0 compilation;
Go to the folder
cd $FOOTMAIN/libs/GenFit
and follow the instructions in the file README.build
SHOE libraries compilation
Go to the SHOE libraries folder
cd $FOOTREF
and compile
make
Then you can
check out that the libraries are properly compiled and placed inside the libs/lib folder.
Level0 compilation and run
Go to the level0 folder and compile the code using the command:
cd $FOOTLEVEL0
make DecodeMC
This will produce as output the
DecodeMC executable. You can run it by doing:
./DecodeMC -in MCinputFile.root
Before running, have a look at the global parameters defined in the global configuration file:
nano $FOOTCONFIG/FootGlobal.par
(exit with ctrl-x).
Input Files
You can find the available MC samples lsted and described
here. They are stored in the Bologna-tier3 site under: /home/FOOT-T3/battistfoott3/SimulatedData.
The current version of SHOE supports
V12.4 simulated samples.
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.
The reconstruction of data events
Still a long way to go...
--
Alessio Sarti - 2016-07-06 --
Schiccio Frank - 2017-07-03
Developer instructions
Anyone who wants to develop its own part of the code and wants to add it back on a second time, should please follows the instrctions below:
- Contact the code managers.
- Download (git clone) of update (git pull) to the latest version of the code (master branch).
- Create your new branch (git checkout -b branchName).
- Work on your branch and commit regularly.
- When your task is done and you wants to merge back to the main (master) branch, contact the code managers (or make a merge request on baltig page).
You can find more information in the following slides done at the SHOE tutorial in Bologna on 7-8th March 2018:
Reconsturction slides &
Ntuple descrition slides
I recall you can find the exercises solution in in the git branch "xxx02", to be compared with the tutorial stable branch "tutorial01".
Comments