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)