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  subrou-
       tines  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 exter-
              nal 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 mix-
       ing 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
       constraints 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),
       FHSetSMPara(1),  FHRetrieveSMPara(1),  FHSetPara(1), FHRetrievePara(1),
       FHSetSLHA(1), FHSetNMFV(1),  FHRetrieveNMFV(1),  FHSetDebug(1),  FHGet-
       Para(1),   FHGetSelf(1),   FHAddSelf(1),  FHHiggsCorr(1),  FHUncertain-
       ties(1),   FHCouplings(1),   FHSelectUZ(1),   FHSelectIpol(1),   FHHig-
       gsProd(1),   FHEWPO(1),   FHConstraints(1),  FGClearRecord(1),  FHRead-
       Record(1), FHLoopRecord(1), FHSetRecord(1),  FHRecordIndex(1),  FHLoad-
       Table(1), FHTableRecord(1)

                                  9-Feb-2017                          LIBFH(1)