HiggsBounds
5.10.2
|
This version of HiggsBounds is not longer maintained. Please use the new version of HiggsBounds, which is part of HiggsTools:
https://gitlab.com/higgsbounds/higgstools
HiggsBounds takes a selection of Higgs sector predictions for any particular model as input and then uses the experimental topological cross section limits from Higgs searches at LEP, the Tevatron and the LHC to determine if this parameter point has been excluded at 95% C.L..
Download the newest release or take a look at the documentation.
The HiggsBounds-5 manual is available here.
Current members of the HiggsBounds team are Philip Bechtle, Sven Heinemeyer, Tobias Klingl, Tim Stefaniak, Georg Weiglein and Jonas Wittbrodt.
In case of questions regarding HiggsBounds please contact Tim and/or Jonas. If you you want to report a bug please open an issue.
Former members are Oliver Brein, Daniel Dercks, Oscar Stål and Karina E. Williams.
HiggsBounds incorporates a large number of experimental results. The list of implemented analyses can be accessed locally through the AllAnalyses
executable (see below) including InspireHEP cite keys and arXiv or experimental report numbers for easy citing. An up-to date version of that list is also available here (as HBAnalyses.txt
) together with a HBAnalyses.bib
file and an example tex file citing all HiggsBounds analyses.
HiggsBounds requires a Fortran compiler supporting at least Fortran 95 (like gfortran
) and cmake
.
The code is compiled by
mkdir build && cd build cmake .. make
If your distribution does not provide a recent version of CMake (e.g. Scientific Linux or CentOS) simply grab the binary version from here.
If you wish to use a different Fortran compiler set the FC
environment variable before running cmake
.
In order to use the chi-squared values from LEP simply add
-DLEP_CHISQ=ON
to the cmake ..
line. This automatically downloads the required data files (see e.g. example_programs/HBwithLEPlikelihood.F90
for an example using this extension).
Some of the example_programs illustrate the use of HiggsBounds together with FeynHiggs. To use these a compiled version of FeynHiggs is required and
-DFeynHiggs_ROOT=/path/to/feynhiggs
has to be set in the to the cmake ..
line. See e.g. example_programs/HBwithFH.F90
for an example.
A test suite that checks the results of the example codes against reference values is included and can be executed through make check
or (for more detailed results) ctest --output-on-failure
. Running the tests requires python>3.5
with the pytest
, numpy
and pandas
packages. The test suite takes a few minutes to complete.
HiggsBounds can be used as a library of Fortran subroutines (see src/HiggsBounds_subroutines.F90
and the subroutine documentation) by linking the build/lib/libHB.a
library. If your project builds using CMake you can simply use
and CMake will take care of everything else.
HiggsBounds provides a C interface in include/HiggsBounds.h
that wraps the Fortran subroutines and takes care of type conversions. When using the C interface, make sure to link any libraries required by the Fortran C interface of your compiler setup (e.g. -lgfortran -lm -lquadmath -lm
for gcc-gfortran). If you use CMake this will be handled automatically.
Compilation generates a binary which can be invoked from the command line as
./HiggsBounds <options>
In addition an AllAnalysis
executable which prints all implemented experimental results, and all example_programs
whose dependencies are met are compiled.