Page MenuHomeHEPForge
Files F11222086

README
No OneTemporary
Actions

README
View Options

Contents of the present directory are part of the program package
HiggsBounds
by Philip Bechtle, Oliver Brein, Sven Heinemyer, Georg Weiglein
and Karina E. Williams.
This is the FORTRAN 90 version of the code, written by Karina Williams.
Please contact k.e.williams@dunelm.ac.uk if you have any questions/problems/etc
with this version.
This README file contains:
* Journal reference and website address
* Software license
* What the program does
* How to use HiggsBounds
* Additional requirements
* How to install HiggsBounds
* How to run the examples
* Additional notes
- changing the values of deltaMh_LEP, deltaMh_TEV or eps
- parallel processing
* Contents of this directory
------------------------------------------------------------------
* Journal References:
Philip Bechtle, Oliver Brein, Sven Heinemeyer, Georg Weiglein,
Karina E. Williams,
HiggsBounds: Confronting Arbitrary Higgs Sectors
with Exclusion Bounds from LEP and the Tevatron,
Comput.Phys.Commun.181:138-167,2010
e-Print: arXiv:0811.4169 [hep-ph]
Philip Bechtle, Oliver Brein, Sven Heinemeyer, Georg Weiglein,
Karina E. Williams,
HiggsBounds 2.0.0: Confronting Neutral and Charged Higgs Sector
Predictions with Exclusion Bounds from LEP and the Tevatron,
e-Print: arXiv:1102.1898 [hep-ph]
* Web site: http://projects.hepforge.org/higgsbounds/
Please have a look at the above papers for detailed information
on the program.
* Software License:
HiggsBounds is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
HiggsBounds is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with HiggsBounds. If not, see http://www.gnu.org/licenses/
* What the program does:
HiggsBounds tests theoretical predictions of models
with arbitrary Higgs sectors against the exclusion bounds
obtained from the Higgs searches at LEP, the Tevatron and the LHC.
The included experimental information comprises exclusion bounds
at 95% C.L. on topological cross sections. In order to determine
which search topology has the highest exclusion power, the program
also includes, for each topology, information from the experiments
on the expected exclusion bound, which would have been observed in
case of a pure background distribution. Using the predictions of
the desired model provided by the user as input, HiggsBounds
determines the most sensitive channel and tests whether the
considered parameter point is excluded at the 95% C.L.
* How to use HiggsBounds:
The code can be invoked on the command line using the command
HiggsBounds <options>
and a subroutine version of the code can be used in other codes
by linking the library
libHB.a .
An online version version can be reached via the URL:
http://projects.hepforge.org/higgsbounds/
By running HiggsBounds without options, more detailed
information on how to invoke it will be displayed.
* Additional requirements:
The program "HiggsBounds" and the FORTRAN library "libHB.a" do not
need to link to other libraries.
The sample program "HBwithFH" demonstrating the use of HiggsBounds
in connection with FeynHiggs needs to link to/include:
libFH.a
FHCouplings.h
The sample program "HBwithCPsuperH" demonstrating the use of HiggsBounds
in connection with CPsuperH needs to link to:
libcpsuperh2.a
* How to install it:
1. ./configure <options>
Use ./configure --help to get a full description of the options.
The most useful options are probably
./configure --prefix=/path/to/HiggsBounds
- allows you to specify where you would like HiggsBounds to be installed
./configure --with-FEYNHIGGS=/path/to/FeynHiggs/installation
- allows you to specify the path to your copy of FeynHiggs
(only needed if you would like to compile the example file HBwithFH.F,
which shows how HiggsBounds and FeynHiggs can be used together)
./configure --with-FCPSUPERH=/path/to/CHsuperH/installation
- allows you to specify the path to your copy of CPsuperH
(only needed if you would like to compile the example file HBwithCPsuperH.F,
which shows how HiggsBounds and CPsuperH can be used together)
./configure --enable-shared="no"
shared libraries are not built
2. make ; make install
This will generate and install the program "HiggsBounds", which is the command-line version of
the code, the HiggsBounds library and some/all of the demo programs (see the output of
the configure file for a list.).
* Examples
- Example of command-line version of HiggsBounds
The HiggsBounds package includes some sample input files in the folder example_data.
For examples, to run HiggsBounds with the sample input files starting with
'HB_randomtest50points_' use, for example:
./bin/HiggsBounds LandH part 3 1 'example_data/HB_randomtest50points_'
The output files are example_data/HB_randomtest50points_HiggsBounds_results.dat
example_data/HB_randomtest50points_Key.dat
The HiggsBounds package also includes the sample output files:
example_data/HB_randomtest50points_HiggsBounds_results.dat-for-comparison
example_data/HB_randomtest50points_Key.dat-for-comparison
These should be identical to the output files generated from running this example.
- Example of the subroutine version of HiggsBounds
The HiggsBounds package includes a example program example_programs/example-SM_vs_4thGen.F
(written in fortran 77) which demonstrates the use of the HiggsBounds subroutines
contained in the HiggsBounds library.
To use, enter the commands:
./bin/example-SM_vs_4thGen
The output files are example-SM-results.dat
example-4thGen-results.dat
Key.dat
The HiggsBounds package also includes the sample output files:
example-SM-results.dat-for-comparison
example-4thGen-results.dat-for-comparison
Key.dat-for-comparison-SM_vs_4thGen
These should be identical to the output files generated from running this example.
- Example of the use of HiggsBounds in conjunction with the publicly available program
CPsuperH
The example program ./example_programs/HBwithCPsuperH.f (fortran 77) uses CPsuperH
(http://www.hep.man.ac.uk/u/jslee/CPsuperH.html) to generate the input required by
HiggsBounds and then calls the HiggsBounds subroutines
(please see the comments in this file for more information).
The file ./example_programs/HBwithCPsuperH.input contains the input for CPsuperH.
To use, make sure CPsuperH is installed on your system and that the paths are
correctly set in the HiggsBounds configure file. Then use:
./bin/HBwithCPsuperH < example_programs/HBwithCPsuperH.input
The HiggsBounds results are outputted to the screen and key to the processes is printed to
the file Key.dat
Note that it is best to use consistent compilers for both the HiggsBounds
and the CPsuperH libraries.
- Example of the use of HiggsBounds in conjunction with the publicly available program
FeynHiggs
The example program ./example_programs/HBwithFH.f (fortran 77) uses FeynHiggs
(http://www.feynhiggs.de) to generate the input required by HiggsBounds and then calls the
HiggsBounds subroutines (please see the comments in this file for more information) .
To use, make sure FeynHiggs is installed on your system and that the paths are
correctly set in the HiggsBounds configure file. Then use:
./bin/HBwithFH
The HiggsBounds results are outputted to the screen and key to the processes is printed to
the file Key.dat
Note that it is best to use consistent compilers for both the HiggsBounds
and the FeynHiggs libraries.
Please feel free to contact us with feature requests and bug reports.
Enjoy!
Karina
---------------------- Additional notes: ------------------------------
The values of the variables
* deltaMh_LEP, deltaMh_TEV (determines how similar the neutral Higgs masses should be for their
cross sections to be combined.) Note that cross sections are not combined for processes
which require the parameter point to be SM-like.
* eps (Determines how strict the SM-like test is.)
(see manual for more precise definitions)
are set at the beginning of the file S95tables.f90. These can be changed if desired.
The command-line version of HiggsBounds is suitable for parallel processing during the
most CPU intensive part of the program (the comparison of the theoretical predictions and
experimental results for each data set). OpenMP directives are contained in the file
HiggsBounds.F90. They can be activated by a compiler flag e.g. for gfortran, use -fopenmp
----------- Contents of directory -----------------
* ./src
- HiggsBounds.F90 : main program for the command-line version of HiggsBounds
- HiggsBounds_subroutines.F90 : contains the main HiggsBounds subroutines which are accessible to the user
- input.F90 : contains subroutines associated with input
- write_out_input.txt : ('#include'd into input.F90) writes input for debugging purposes
- output.F90 : contains subroutines associated with output
- theo_manip.f90 : contains subroutines for the initial manipulation of the input data
- channels.F90 : contains subroutines involving the list of channels
- S95tables.f90 : contains subroutines involving individual channels/topologies
- S95tables_type1.f90 : fills the array S95_t1, which contains the data from the 1D experimental tables
- S95tables_type2.f90 : fills the array S95_t2, which contains the data from the 2D experimental tables
- interpolate.f90 : contains routines for interpolating the tables
- theory_BRfunctions.f90 : contains SM branching ratios used internally by HiggsBounds
- theory_tevSfunctions.F90 : contains SM cross section ratios used internally by HiggsBounds
- theory_XS_SM_functions.F90 : contains SM cross section used internally by HiggsBounds
- access_SM.f90 : SM functions which are accessible to the user
- usefulbits.f90 : defines, allocates and deallocates various variables (in particular, the command-line input, the array of input data and the output array)
- extra_bits_for_web.F90 : extra subroutines required by the website version of the code
- read_commandline_from_web.txt : ('#include'd into extra_bits_for_web.F90) reads numbers from command line given by web cgi script
- no_SLHA.f90 : contains dummy subroutine which is used when input is not in SLHA format
- extra_bits_for_SLHA.f90, SLHA_manip.f90, PDGnumbering.f90, string_manip.f90
: files associated with input in SLHA format (unsupported option)
- README : contains information about the code
- COPYING : The GNU General Public License
- configure : sets compiler options, paths to data and libraries, creates makefile, runs the script create_store_pathname.bat
- makefile.in : used by configure to create the makefile
- create_store_pathname.bat : creates a fortran module which stores the path to the installation directory
- create_package.bat : simple shell script to create the tar.gz file
- extract_SM_results_for_web.f90 : script to make the SM functions accessible on the website
* ./src/Expt_tables
Contains tables of limits from LEP, CDF and D0 experiments as a function of Higgs mass
* ./src/Theory_tables
Contains tables of SM branching ratios and total decay width as a function of Higgs mass, generated using the program HDecay.
* ./src/cs-ratios_sigma-bg-Hb
Contains functions for Tevatron SM partonic cross-sections and cross-section ratios
* ./example_data
Contains example input and output files
* ./example_programs
- example-SM_vs_4thGen.F : example fortran program, showing the use of HiggsBounds subroutines
- HBwithCPsuperH.f : example fortran program, showing the use of HiggsBounds subroutines with the program CPsuperH
- HBwithCPsuperH.input : input for HBwithCPsuperH.f
- HBwithFH.F : example fortran program, showing the use of HiggsBounds subroutines with the program FeynHiggs

File Metadata

Mime Type
text/plain
Expires
Wed, May 14, 11:23 AM (14 h, 31 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
5071458
Default Alt Text
README (12 KB)

Event Timeline