OpTHyLiC is a software tool computing observed and expected upper limits on poissonian process rates using a hybrid frequentist-bayesian CLs method. This tool can be used for simple counting experiments where only signal, background and observed yields are provided or for multi-bin experiments where binned distributions of discriminating variables are provided. It is simple, light, and fast. Even in realistic cases with dozens of nuisance parameters and several channels, limits are typically computed in less than one minute. It can be used with an arbitrary number of channels and backgrounds. It takes into account statistical and systematic uncertainties, as well as correlations of systematic uncertainties across samples and channels.
OpTHyLiC can be downloaded below. On this page can also be found the documentation of this software together with its prerequisites and with basic intructions for installation and usage, as well as informations about its developpers and its licence.
E. Busato, D. Calvet, and T. Theveneaux-Pelzer, OpTHyLiC: an Optimised Tool for Hybrid Limits Computation, arXiv:1502.02610 [hep-ex], Computer Physics Communications 226 (2018) 136-150.The authors would be thankfull to the OpTHyLiC users for citing this paper whenever this software is used for a study reported in a public document.
Details of the usage of the code can be found in the online documentation.
To use OpTHyLiC, a version of the ROOT software is needed. Versions as old as 5.28/00b have been tested, but older ones may also be ok.
OpTHyLiC can be run with ROOT macros, but executables can also be compiled. In that case, the gcc compiler is needed. Versions as old as 4.3.0 have been tested, but older ones may also be ok. To use a different compiler, one would have to modify the INSTALL script mentioned below.
If the features involving the C++11 standard are to be used, gcc 4.8.2 or newer is needed for creating executables. For running OpTHyLiC with ROOT macros with these C++11 features, ROOT 6.02/03 or newer is required.
More details can be found in Section 4.1 of the documentation.
In the second step, the shared libraries are compiled according to the Makefile.
Finally, the script sourced in the last step updates the LD_LIBRARY_PATH environment variable with the directory where the shared libraries are available.Once installed, the libraries can be used from anywhere after having sourced the setup.[c]sh script. The example script runLimits.C, available in the examples/ directory, illustrates the computation of limits. It can be used with the following syntax:
OpTHyLiC has been developed by Emmanuel Busato, David Calvet and Timothée Theveneaux-Pelzer, from the
ATLAS team at the LPC Clermont-Ferrand.
Questions and suggestions may be sent to the following e-mail address:
Several uses of OpTHyLiC are referenced here. If you use OpTHyLiC, please let us know and we will add your document to the list.