This is a fork of the HiggsAnalysis-CombinedLimit tool, developed by the CMS collaboration. The original tool is used by many analyses in the collaboration, not only in the Higgs sector. For more information how to use it, follow the documentation in the original repository.
This fork was done on the 23. March 2019 from the 81x-root606
branch at the commit with the hash 5cc169efd9233011924e5fbd468ef05be044ed39
. The goal was:
- Easy standalone complilation with cmake
- modernize the tool by consistently applying the C++ 17 standard and porting all Python code to Python 3
- make the code nicer by applying clang-format on the C++ code and formatting the Python code with black
With version 1.0 of this fork, the code differs from the original only by the points listed above plus the removal of non-essantial files from the repository. It will be decided in the future if compatibility with the original will be kept or if the functionality will diverge to ensure a modern workflow, flexibility and ease of use.
After version 1.0, the goals shifted a bit and with be outlined in the following.
Combine consists of both Python and C++ code, which can be installed together as a python package. Please follow these steps for a clean installation:
- Clone the repository recursively and change directory:
git clone --recursive [email protected]:guitargeek/combine.git cd combine
- Set the location of the header files at install time:
Please copy the headerfiles somewhere else before and set the
export COMBINE_INCLUDE_DIR=$PWD/include
COMBINE_INCLUDE_DIR
accordingly if you plan to delete or move the repository after the installation. - Installation of the package:
pip install --user .
Two unusual build and runtime requirements, which are usually not installed in the usual linux system are:
- The ROOT framework
- CERN VDT for fast math
For Arch Linux, these requirements are provided by the official repositories in the root and cern-vdt packages.
After installing the combine tool, you can test it by running the Brazilian plot example to reproduce the plot at the top of this readme file. So far, this is the only supported example.
For development, one does not want to do the full installation because it would take too long to recompile and install everything with setuptools. Instead, it makes more sense to use cmake directly for the C++ code:
git clone --recursive [email protected]:guitargeek/combine.git
cd combine
mkdir build
cd build
cmake ..
make -j8
export COMBINE_LIB_DIR=$PWD/lib
export PYTHONPATH=$PYTHONDIR:$COMBINE_LIB_DIR
When the COMBINE_LIB_DIR
is set, the Python package is now separated from the C++ library. The C++ code is now not always recompiled if you install the python package.
Note that this time you don't need to set the COMBINE_INCLUDE_DIR
variable. When you use cmake directly, it will just use the headers from the include directory in the repository.
To format the whole C++ code:
find include -regex '.*\.\(cpp\|hpp\|cc\|cxx\|hh\|hxx\|h\)' -exec clang-format -style=file -i {} \;
find src -regex '.*\.\(cpp\|hpp\|cc\|cxx\|hh\|hxx\|h\)' -exec clang-format -style=file -i {} \;
To format the whole Python code:
black --line-length 120 .