FOOT software tutorial page

Software tutorial of Jan 2020

The indico page of the tutorial can be found here.

Prerequisites

To participate to the Jan 2020 tutorial the following actions have to be taken before:

• The participant needs to have access to a shoe Master branch installation that is complete, up to date and tested for proper running (see instructions below).
• If the participant is not planning to use the tier3 for his hands on session, the files needs to be downloaded and be available for the exercises in the local installation.
• The list of the files that will be needed follows. Files can be copied using the scp command from the tier3 (XXXfoott3@uibo-foot-01.cr.cnaf.infn.it:/gpfs_data/local/foot/Simulation/XXXX)
  1. MC files
     • The folder is: /gpfs_data/local/foot/Simulation/Tutorial
     • Inside you can find two subfolders that contain the CNAO2020 and Full folders (with obvious meaning). Each folder contains:
       1. The old (now deprecated) output of Txt2Root : 12C_C_200.root
       2. The new shoe output of Txt2NtuRoot: 12C_C_200shoe.root
       3. the geo, inp and flair files used to generate the sample
     • To use the CNAO2020 files you need to specify the -exp CNAO2020 -run 1 flag while to use the Full files the flag should be -exp 12C_200 -run 1
  2. Data files:
     • The folder is: /gpfs_data/local/foot/DataGSI_match/
     • Inside you can find the data related to the GSI data taking. The tutorial will be focusing on run 2211.
       1. data_built.2211.*VTX* (file containing the vtx info)
       2. data_built.2211.*WD* (file containing the timing info)
     • To use the GSI files you need to specify the -exp GSI -run 2211 flag
  3. Hands on sessions.
     • The MC session will need the files provided via googledrive

The files can also be downloaded from google drive

We assume that the participants have basic knowledge of ROOT and linux/macosx environments.

Installing and testing the installation

The tutorial will be based on the use of the Master branch.

The instruction on how to download and install the code either on the tier3 site or on a local linux or macosx installation are documented in the software page. For details, please refer to that page. In short, hereafter we recall the basic steps in order to get a running version of the updated Master branch.

Update of an existing installation

If you have an existing installation of the shoe software and already switched to the Master branch, you just need to:

1. Go to the Master branch installation inside the shoe folder
2. Issue the 'git pull' command
3. Issue the cmake command 'cmake PathToMaster /shoe -DCMAKE_BUILD_TYPE=Debug'

• -DFILECOPY=OFF with the copy flags off (default value ON)
• -DTOE_DIR=OFF with compiling TOE package off (default value ON)
• -DGENFIT_DIR=OFF with compiling GenFit package off (default value ON)
• -DBENCHMARK=ON with running a benchmark macro (default value OFF)
• -DANC_DIR=ON with ancillary detectors folder compilation on (default value OFF)
• -DGeant4_DIR=pathToGeant4 with Geant4 folder compilation (default value OFF)

1. Issue the make command
2. Issue the source setup.sh or .csh commands accordingly to your shell

Starting from scratch: local installation

First of all, be sure that your ROOT installation is compliant with the requirements set by the master branch. If not, you'll need to recompile ROOT with the proper flags. To check the root flags you can use the

root-config --cflags

command and verify that the option -std=c++14 appears in the output string.

Otherwise the recommended cmake options are the following:

-Drpath=ON -Dminuit2=ON -Dcxx14=ON -DCMAKE_BUILD_TYPE=Debug

Once ROOT is properly setup you can proceed with the following steps.

1. Download the Master branch using the 'git clone https://xxxx@baltig.infn.it/asarti/shoe.git' command. Replace xxxx with your user account under baltig.
2. Enter the shoe directory: cd shoe
3. switch to the master branch: git checkout master
4. Create the build directory and enter it: mkdir build; cd build
5. Issue the cmake command 'cmake PathToMaster /shoe -DCMAKE_BUILD_TYPE=Debug' (same options as above could be applied).
6. Issue the make command
7. Issue the source setup.sh or .csh commands accordingly to your shell

Starting from scratch: tier3 installation

The instructions on how to access the tier3 are given in the software page.

You need, as a first thing, to setup properly the environment.

scl enable devtoolset-9 bash

In order to compile and install the shoe software on the tier3 you must use a properly compiled version of ROOT.

To check the root flags you can use the

root-config --cflags

command and verify that the option -std=c++14 appears in the output string. If your 'local' ROOT installation does not have the proper flags, you can use the ROOT from , by issuing the command

source /opt/exp_software/foot/root/root-6.20.04/bin/thisroot.sh 

and check afterrwards that the root-config command provides the expected output.

Once ROOT is properly setup you can proceed with the following steps.

1. Download the Master branch using the 'git clone https://xxxx@baltig.infn.it/asarti/shoe.git' command. Replace xxxx with your user account under baltig.
2. Enter the shoe directory: cd shoe
3. switch to the master branch: git checkout master
4. Create the build directory and enter it: mkdir build; cd build
5. Issue the cmake command 'cmake3 PathToMaster /shoe -DCMAKE_BUILD_TYPE=Debug' (same options as above could be applied).
6. Issue the make command
7. Issue the source setup.sh or .csh commands accordingly to your shell

Testing the installation

To check wether your installation is properly working in view of the tutorial, you are encouraged to perform the following tests.

First of all, execute the 'source setupFOOT.sh' inside the build directory and then run the following macro: 'root pathToMaster/Reconstruction/level0/macros/BenchMark.C+' in your pathToBuild//Reconstruction/level0 folder

-- Alessio Sarti - 2020-12-29

Comments