Installing the DST Tools

Preliminaries

Preliminaries

You must have these build tools available on the system.The DST maker and HpsEvent API require the following packages before they can be built: 

• GCC
  
  • version >= 4.8 (need C++11 support)
• The LCIO C++ API
• CMake
  • version >= 2.8

These package dependencies must be installed as well (details covered below):

• LCIO
  
  • trunk or the last release should work fine
• ROOT data analysis frameworkROOT
  
  • tested with 5.34/11 but any version greater than this should work
• Generalized Broken Lines
• CMake
  • version >= 2.8
• Doxygen (Optional. Used to build the documentation.)

If you want to build the documentation then this is also required.

• Doxygen

Linux Build Environment

SLAC

The default, shared Linux environment at SLAC can not be used as the version of gcc is too old.

A more recent environment can be setup and checked as follows.

ssh rhel6-64
scl enable devtoolset-2 bash
gcc --version

You should see the following gcc version now.

(GCC) 4.8.2 20140120 (Red Hat 4.8.2-15) Copyright (C) 2013 Free Software

This version of the compiler should support the C++11 standard.

JLAB

An alternate compiler also needs to be setup to override the default one.

export PATH=/apps/gcc/4.8.2/bin/:$PATH
gcc --version

You should see the following GCC version.

gcc (GCC) 4.8.2

This version should support C++11.

Installing CMake

It is likely your system already has a recent enough version of CMake installed on it.

...

$ which cmake
/usr/bin/cmake

$ cmake
cmake version 2.8.12.2
[...]

If CMake is not found or the version is too old, then follow the Installing CMake guide to build it.

...

Follow the instructions at the ROOT website to install it. 

Then you will want to source the setup script which will set the ROOTSYS variable.

. bin/thisroot.sh

Installing GBL

...

...

This should set ROOTSYS to point at your ROOT installation.

Getting the Source Code

Cloning the Repository from Github

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.

...

A github account is not required to clone the source code.

Getting a Tagged Release

You may also want to use a tagged release.  For instance, the v0.7 tag can be downloaded from the following URL.

https://github.com/omar-moreno/hps-dst/releases/tag/v0.7

Or you can execute these shell commands.

wget https://github.com/omar-moreno/hps-dst/archive/v0.7.tar.gz
tar zxvf v0.7.tar.gz
cd hps-dst-0.7

Now you may build the project locally in the usual way.

Building the Project

Before the project is built, the following environment variables need to be set.

...

Then the project should be built as follows.

cd hps-dst/ 
mkdir build; cd build
cmake ../
make

...