BHEP Installation Guide

Getting the source

The average user (non-developer) should download the latest tag available at the NEXT Subversion repository:

svn export svn://neutrinos1.ific.uv.es:/svn/bhep/tags/vXrYpZ vXrYpZ

That will download BHEP tag vXrYpZ and store it in local directory vXrYpZ.

Developers may want to check out the trunk or a given branch:

svn co svn://neutrinos1.ific.uv.es:/svn/bhep/trunk trunk

External Dependencies

BHEP depends on GNU Autotools and ROOT. Below you'll find what they are, what they are used for in BHEP and how to install them.

GNU Autotools

ROOT

BHEP depends on ROOT for I/O. Instructions on how to install ROOT from source can be found at: http://root.cern.ch/drupal/content/installing-root-source. You can also decide to install one of the pre-built binaries for your architecture. See available binaries at: http://root.cern.ch/drupal/content/downloading-root

You should install ROOT version >= 5.14.

Once ROOT is installed, make sure to have:

• $ROOTSYS environment variable pointing to the ROOT top-level directory, eg the one above ROOT's lib
• $ROOTSYS/bin in your $PATH
• $ROOTSYS/lib in your $LD_LIBRARY_PATH (or $DYLD_LIBRARY_PATH)
  
• $ROOTSYS/lib in your $PYTHONPATH

Compiling BHEP

The latest tag can be obtained from our Subversion repository:

svn export svn://neutrinos1.ific.uv.es:/svn/bhep/tags/vXrYpZ bhep_vXrYpZ

To compile BHEP you will need an ANSI C++-compiler. Move to

bhep_vXrYpZ/bhep3

and type:

./autogen.sh

You may get ocassionaly a complain about headers not found in this case rerun autogen.sh again. It autogen.sh fails, check your autoools installation. Or, run the autoools by hand.

aclocal autoheader libtoolize --automake automake --add-missing --gnu autoconf

You need some decently recent version of autotools (2.53 is recommended). After running autogen.sh you can run

./configure

Notice that you can try to run ./configure DIRECTLY, whitout running ./autogen.sh. Most probably it will work.

You can then build the library by typing,

make

The library can be installed using the command,

make install

The default install directory prefix is /usr/local. You can change this by tipying:

make install --prefix=YOUR_INSTALL_DIR

Be sure that you include in your path YOUR_INSTALL_DIR/bin (/usr/local/bin by default. Then check the command

bhep-configure

that will tell you everything about bhep instalation.

Python support:

Once bhep is installed, it can be accessed from python via pyROOT. To install bhep as a python module, just type

python setup.py install

BHEP analysis tools (ccentella):

To compile ccentella, move to

bhep_vXrYpZ/ccentella

and follow the same steps.

-- Main.pnovella - 19 Apr 2010