Introduction

This a custom ROOT library that provides a framework for physics analysis. It contains several functions and classes that aid in analyzing high energy physics data. To aid in the compilation of all the source code, a macro entitled 'CompileSource.C' can be executed from the command line. All functions and classes are available in python from the lib/HAL.py module. Furthermore, everything lives in the 'HAL' namespace. HAL stands for
H - H.E.P.
A - Analysis
L - Library
Of course, this is also a thinly veiled reference to the villian in the classic "2001: A Space Odyssey." But, I personally think this bit of software is far less pernicious.

Requirements and Installation

This software requires a working version of ROOT along with a compatable version of python if one is to use HAL.py (in other words, you need to be able to use PyROOT from anywhere in your system). Additionally, it requires a few modifications to your ROOT and python environments. Here are the steps to installing this software:

1. Run the CompileSource.C macro: 'root -q -b -l CompileSource.C'
2. Add the 'lib' folder to your Unix.*.Root.DynamicPath (or Windows equivalent) in .rootrc
3. Add the 'include' folder to your ACLiC include path in .rootrc
   (e.g. ACLiC.IncludePaths: -I$(HOME)/src/HAL-ROOT/include)
4. Optional: Add the 'lib/python' folder to your PYTHONPATH
5. Optional: Add 'lib' to Unix.*.Root.MacroPath for easy loading of the library in an interactive ROOT session (e.g. '.L libHAL.so')

Documentation

There is documentation for all functions and classes in Doxygen format. Additionally, an extensive user's guide is located in the 'docs' folder.

Analysis

To aid in rapid development of physics analysis, a ROOT macro for compiling user's algorithms and analyses is provided in the SampleAnalysis subfolder. Instructions for how to use this macro are given at the top of the macro.

Testing

To test that everything is correctly there are several macros and python scripts in the tests folder. They should work like any other ROOT macro or python script ('root -b -q test.C' and 'python test.py'). There is also an example analysis in the SampleAnalysis subfolder.

TODO

• Write Doxygen and Users' Guide
• Add counter to CutAlgorithm class and efficiency report
• Make python class for Algorithm share fInput TList with C++ and vice versa
• Improve usability of Interpolator class
• Expand AnalysisTreeReader to read in histograms
• Allow for weigths in CutOptimizer
• Develop CMake build system