The HPS Data Summary Tape (DST) maker uses the LCIO C++ API to read collections of physics objects (e.g. ReconstructedParticle, Track) from reconstructed LCIO files and convert them to ROOT data structures. The resulting ROOT files can be analyzed using the HpsEvent API in combination with the ROOT data analysis framework.
In order to build the project, the following build tools are required:
The project has the following dependencies:
- The LCIO C++ API
- ROOT data analysis framework ** Compatible with both ROOT versions 5 and 6 if build with cmake.
In order the build the documentation, the following package is also required:
Unless you are an active developer on the project, it is best to use a tagged release. A release can be downloaded from the projects release page. The project can be downloaded as a zip file or tag.gz file.
Alternatively, a release can be downloaded and untarred by issuing the following commands from a terminal
wget https://github.com/JeffersonLab/hps-dst/archive/v0.10.tar.gz
tar zxvf v0.10.tar.gz
cd hps-dst-0.10
Once downloaded, the package can be built in the usual way.
The project is stored in a public github repository. The code can be "cloned" i.e. copied to a users local machine by issuing the following commands from a terminal
cd /path/to/workdir
git clone https://github.com/JeffersonLab/hps-dst.git
A github account is not required to clone the source code.
Before building the project, the following environmental variables need to be set:
ROOTSYS=/path/to/root
LCIO=/path/to/lcio
The project can then be built as follows:
cd hps-dst
mkdir build; cd build
cmake ..
make
In addition, you can specify the install directory if you which to install hps-dst in a different location from "build" or the hps-dst source directory. This follows the standard cmake convention, so:
cd build
cmake -DCMAKE_INSTALL_PREFIX=/path/to/installation/location
make
make install
If you add the switch: "-DHPS_INSTALL_ALL_LIBS=ON", cmake will install all the libraries and not only libHpsEvent.
For more information on the cmake variables used you can use:
cd build
cmake -LH ..
This will create the binaries (in the build/bin directory) along with the shared library HpsEvent.so (in the build/lib directory) which contains the ROOT dictionary and HpsEvent API.
If Doxygen is installed, the API documentation can be generated as follows:
make doc
This will generate both LaTex and html documentation in the directory hps-dst/doc.
- Omar Moreno (SLAC National Accelerator Laboratory)