UBAna

Based on https://github.com/drinkingkazu/LiteFMWK.

How to use it

Clone the repository:

git clone https://github.com/marcodeltutto/UBAna.git
cd UBAna

Just try:

source setup.sh

This sets up necessary shell env. variables. You need to have ROOT6 (if not, you get an error message from setup.sh). The suppoerted ROOT version is v6.06.06. There's a support to detect numpy and provide a few handy compiler directives as well. Although numpy is not required to run the basic functionalities of this code. This software is compatible with both macOS and linux operative systems.

To build:

make

Then you are good to go. In a new session, just source the setup script.

How to run the CCInclusive analysis

The code is logically divided into two parts:

the Maker, that loops over the events in the ubxsec file, and makes all the necessary histograms needed for the analysis. The Maker needs to be run over MC, and data files.
the Analyser, that takes the files produced by the Maker as input , produces all the relevant plots, and extracts the cross section.

The python script Main/mac/run_maker.py allows to run the Maker over the BNBCosmic MC file, and the EXTBNB and BNBON data files. You need to modify run_maker.py so that it will take as input the UBXSec files that you have produced.

The python script Main/mac/analyse.py allows to run the Analyser and extract the cross section. You need to modify the script so that it will take the files produced by the Maker as input. You also need to set the right number of BNBON and EXTBNB triggers. To retrive the number of trigger events from a UBXSec file, you can use this script: https://github.com/marcodeltutto/UBXSec/blob/master/Utils/countPOT.py.

More information for developers

How to make a new package?

Just try:

gen_my_package Aho

... which will generate a directory named Aho under the repository top directory. A new package comes with GNUmakefile which allows you to compile a package by simply typing make in the package directory. You also find sample.h and sample.cxx. These are very much empty C++ classes just to demonstrate that you can make and access them from an interpreter.

python -c "import ROOT;print ROOT.Aho.sample()"

Generating a new class

In a package directory you can generate a new class. You can of course just type-it-up from scratch. You can also try:

gen_my_class Tako

... which generates Tako.h and Tako.cxx much like sample class. Again, to compile, you can just type make.

If you have written your class from scratch, make sure you add your class to LinkDef.h if you want a dictionary generation (e.g. if you want an access from an interpreter).

Example?

You can find an example in this branch:

git checkout example

Compiling multiple packages

No one wants to cd package directory and make for every package. You can utilize the top level GNUmakefile which is extremely simple and hopefully self-descriptive. All you need to do is to list (space-separated) packages in SUBDIRS variable.

Excluding a class from dictionary generation

Sometimes you don't want to expose your C++ class to an interpreter. Assuming your C++ class is already registered in the dictionary (a mechanism to make your class available in an interpreter), simply exclude it from LinkDef.h.

If you wonder when you want to do it, here's some example reasons:

Compilation is so slow (auto-generated dictionary source code is usually really long, like easily 10,000 lines, taking long time to compile)
Ugh I keep getting dictionary compilation error (auto-generation of dictionary source code is far from being perfect, especially for the latest C++ standards... if troublesome, exclude)

Making inter-package dependencies

To make one package depend on another, you typically want to know 2 information: headers to be included and libraries to be linked against. Here are two pieces of information you may find it useful/handy:

Package libraries are compiled and available under $MYSW_LIBDIR/libLiteFMWK_$(PACKAGE_NAME).so
Package header files are copied and available under $MYSW_INCDIR/ubana/$(PACKAGE_NAME) ... where you substitute $(PACKAGE_NAME) with the actual name string.

With these info, you know what you need to do for your new package compilation that depends on those.

Add compiler flags

-I$(MYSW_INCDIR)
-L$(MYSW_LIBDIR) -lLiteFMWK_$(PACKAGE_NAME).so

Include statements in the source codes

#include "ubana/$(PACKAGE_NAME)/$(WANTED_HEADER)"
... where $(WANTED_HEADER) is the header file you want (like sample.h).

For example, add:

INCFLAGS += -I$(MYSW_INCDIR) 
LDFLAGS += -L$(MYSW_LIBDIR) -lLiteFMWK_Base

just before

include $(MYSW_DIR)/Makefile/Makefile.${OSNAME}