OXSX

Signal Extraction framework for the SNO+ experiment

Dependencies

1. GCC compiler capable of compiling C++ code to the C++11 standard: GCC version 4.8.5 that comes default with CentOS7 systems is good enough.

2. Armadillo is a linear algebra package used for quick matrix multiplication

3. GSL - likely you already have this installed, especially if you are running RAT

4. SCons Is used for the build, also a dependency for RAT

5. HDF5 Should be configured to install with c++ support ./configure --enable-cxx && make && make install

6. ROOT Should be installed with Minuit2 enabled ./configure --enable-minuit2

Installation Instructions

Follow the installation instructions for each of the above using either the default install location or a different directory if you would prefer. Be careful to start the install with a clean environment.

1. Clone this repository with git clone https://github.com/snoplus/oxsx.git --recursive if you've already cloned without the recursive flag just run git submodule update --init

2. If your dependencies are somewhere the compiler can't find them, copy config/userconfig.ini.template to config/userconfig.ini and add the relevant paths. Missing entries are assumed to be in standard locations. e.g.

   [root]
   header_path : <path/to/headers>
   lib_path    : <path/to/libraries>
   

3. Run scons && scons units: this will compile the OXSX library and subsequently the unit tests.

4. Test the build was sucessful with ./test/RunUnits

   If you get the error: catch.hpp: No such file or directory check you used the --recursive option when git cloning.

Compiling Your Own Scripts

scons auto-generates a script that compiles and links your c++ against the source code and dependencies just run . <oxsx root>/bin/compile.sh <your cpp file> to produce an executible of the same name

Look in <oxsx root>/examples for help getting started

Creating ntuples

One way to read in data is using a ROOT ntuple. If you are looking at SNO+ data, you probably have a flat root tree that can be easily pruned down into this format with only the branches you are interested in.

To create ntuples for oxsx run ./util/prune_flat_tree <path_to_file_to_convert> -treename <name_of_the_tree> <branch1> <branch2> <branch3> -newtreename <name_of_your_tree> -outputfile <name_of_your_file> -nevents <number_of_events>

• The name of the tree in an input file is optional, as a default it is "output"
• The name of the output file is optional, as a default is is <the_name_of_input_file>+"_oxsx.root"
• The name of the tree in an output file is optional, as a default it is "oxsx"
• The number of events of an output file is optional