Home

hps-analysis

This is some C++ code that creates ROOT files from slcio (output of the HPS reconstruction and simulation codes) files. Please see the Documentation section on how to use the resulting ROOT files.

Building the code.

Pre-requisite: ROOT

You will need a function version of ROOT, preferably version 6.22 or later. You can find installation instruction on the ROOT Website After installation, make sure you have executed the ROOT startup script before continuing, eg:

source <path-to-root>/bin/thisroot.sh

Pre-requisite: LCIO

This code is not standalone. You will first need to install a copy of LCIO. With HPS we do not use the master branch, instead we use a modified V2.07.05 version, which you can install with the instructions below. First go to a directory where below which you want to build this code, and then execute:

git clone https://github.com/JeffersonLab/hps-lcio.git
cd hps-lcio
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/data/HPS ..
make
make install

Note that you need to adjust the /data/HPS path to your own installation loation.

Building MiniDST:

Again, go to a location below which you want to build this code, and execute the commands below:

git clone https://github.com/JeffersonLab/hps-analysis.git
cd hps-analysis
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/tmp -DLCIO_DIR=/location/of/lcio/installation ..
make
make install

Note that you need to adjust the /tmp path to your own installation location and /location/of/lcio/installation to the location where LCIO was installed in the previous step. That second argument is not needed if the CMAKE_INSTALL_PREFIX is the same in both steps.

Using the executable make_mini_dst.

The make_mini_dst program, which will be installed in bin in the installation step, is used to transform an LCIO file to a ROOT file. Simple usage:

make_mini_dst infile.slcio  -o my_root_file.root

There are several options to fine tune the ROOT file creation, which are shown when you execute the code with the "-h" switch.