libFH
libFH - the FeynHiggs library
libFH is a library of Fortran subroutines for calculating the masses and
couplings of the Higgs sector in the MSSM. The FeynHiggs subroutines
can also be accessed through the command-line frontend FeynHiggs or
through the Mathematica frontend MFeynHiggs.
libFH provides the following subroutines:
--- SETUP ---
FHSetFlags, FHRetrieveFlags
sets/retrieves the flags for the computation, e.g. which renor-
malization scheme to use, or the scope of the calculation.
FHSetSMPara, FHRetrieveSMPara
sets/retrieves the SM input parameters.
FHSetPara, FHRetrievePara, FHRetrieveOSPara
sets/retrieves the numerical parameters for the computation, i.e.
the values for MSSM masses and breaking parameters.
FHSetSLHA
extracts the parameters from a SUSY Les Houches Accord data
structure.
FHSetNMFV, FHRetrieveNMFV, FHSetLFV, FHRetrieveLFV
sets/retrieves the flavour-violating parameters.
FHSetDebug
sets the FeynHiggs debug level.
FHGetSMPara, FHGetPara
retrieves (some of) the SM and MSSM parameters computed from the
input values by FHSet(SM)Para.
--- COMPUTATION ---
FHHiggsCorr
calculates the corrected Higgs masses together with the corre-
sponding effective mixing angle and mixing matrix.
FHUncertainties
computes estimates for the uncertainties of the Higgs masses and
mixings.
FHCouplings
calculates the Higgs couplings to fermions and gauge bosons and
the Higgs self-couplings for a given mixing matrix.
FHSelectUZ
chooses whether to use UHiggs or ZHiggs for internal and external
Higgs bosons.
FHSelectIpol
chooses between interpolation in At vs Xt and Ab vs Xb.
FHHiggsProd
calculates (approximate) Higgs production cross-sections,
FHEWPO evaluates electroweak precision observables.
FHFlavour
evaluates flavour observables.
FHConstraints
evaluates further constraints, such as g-2.
FHOutput
run FeynHiggs functions and produce output according to a key and
write the output to a file.
FHOutputSLHA
run FeynHiggs functions and produce output according to a key and
save the results in an SLHA data structure.
--- RECORD AND TABLE HANDLING ---
FHClearRecord
initializes a FeynHiggs Record.
FHReadRecord
read a file into a FeynHiggs Record.
FHSLHARecord
convert an SLHA data structure to a FeynHiggs Record.
FHLoopRecord
advances the loops contained in a FeynHiggs Record.
FHSetRecord, FHRetrieveRecord
sets/retrieves the FeynHiggs parameters from/to a FeynHiggs
Record.
FHRecordIndex
translates a parameter names into its index in a FeynHiggs
Record.
FHLoadTable
loads a data file into the internal table.
FHTableRecord
associates a FeynHiggs Record with the internal table.
General remarks: All FeynHiggs subroutines have an error flag as their
first argument, and one should not proceed with the calling sequence if
a non-zero error value is returned.
The following gives a rough calling sequence, leaving out many of the
optional functions. Before invoking the actual calculation, the flags
and parameters have to be set up with
call FHSetFlags(...)
call FHSetPara(...)
Some of the MSSM parameters computed from the input values by FHSetPara
can be retrieved using
call FHGetPara(...)
Now the main calculation can be invoked with
call FHHiggsCorr(...)
This yields the corrected Higgs masses, the sine of the effective mixing
angle, and the Higgs mixing and Z-factor matrices. Estimates for the
uncertainties of these quantities can be obtained with
call FHUncertainties(...)
The Higgs decay rates, branching ratios, and couplings corresponding to
the most recent values calculated by FHHiggsCorr can be obtained with
#include "FHCouplings.h"
call FHCouplings(...)
Electroweak precision observables, flavour observables, and further con-
straints can respectively be obtained with
call FHEWPO(...)
call FHFlavour(...)
call FHConstraints(...)
Just add the path to libFH.a and -lFH to the compiler command line, as
in:
f77 myprogram.f -L -lFH
For example:
f77 myprogram.f -L$HOME/FeynHiggs-x.y.z/i586-linux/lib -lFH
FeynHiggs(1), MFeynHiggs(1), FHSetFlags(1), FHRetrieveFlags(1), FHSetSM-
Para(1), FHRetrieveSMPara(1), FHSetPara(1), FHRetrievePara(1), FHSet-
SLHA(1), FHSetNMFV(1), FHRetrieveNMFV(1), FHSetDebug(1), FHGetPara(1),
FHGetSelf(1), FHAddSelf(1), FHHiggsCorr(1), FHUncertainties(1), FHCou-
plings(1), FHSelectUZ(1), FHSelectIpol(1), FHHiggsProd(1), FHEWPO(1),
FHConstraints(1), FGClearRecord(1), FHReadRecord(1), FHLoopRecord(1),
FHSetRecord(1), FHRecordIndex(1), FHLoadTable(1), FHTableRecord(1)
9-Feb-2017 LIBFH(1)