1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
|
The Les Houche Accord Parton Density Function library - LHAPDF
==============================================================
Introdution.
===========
The Les Houches Accord Parton Density Function interface originated at the
Les Houches 2001 workshop [1] in the PDF working group to enable the usage
of Parton Density Functions with uncertainties in a uniform manner.
When PDFs with uncertainties are considered, a ``fit'' to the data no longer
is described by a single PDF. Instead in its most flexible implementation,
a fit is represented by a PDF set consisting of many individual members.
Calculating the observable for all the PDF members enables one to reconstruct
the uncertainty on the observable. The LHAPDF interface was made with this
in mind and manipulates PDF sets.
The LHAPDF interface can be viewed as a successor to PDFLIB [2].
Many improvements were added, to list some of the features:
* The handling of PDF sets to enable PDF fits that include uncertainties.
* All PDF sets are defined through external files in either parameterized or
grid form. The parameterized files are compact compared to the grid files,
but the latter allow faster usage when multiple PDF sets are called frequently
and also allow older PDF sets to be made available in LHAPDF. New PDF sets can
be defined by constructing the PDF defining parameter or grid files. The actual
LHAPDF code does not have to be changed unless, in the grid file case, the
authors of the PDFs use new interpolation methods.
* The LHAPDF code is modular and default choices can be easily altered.
Note that the current ``best fit'' PDFs can be viewed as sets with one member
PDF and can be easily defined through the PDF set external file definition.
Alternatively one can group these ``fits'' is single sets (e.g. MRST98 set) as
they often represent best fits given different model assumptions and as such
reflect theoretical modeling uncertainties.
Mailing List.
=============
A mailing list 'lhapdf-announce' has been set up to inform users of any
changes and new versions of the LHAPDF library. If you would like to be on
this list then please send a message to majordomo@cedar.ac.uk with the
following words in the body of the message: 'subscribe lhapdf-announce'
You will receive by reply a message containing a subscribe string with a
password which you should resend to majordomo@cedar.ac.uk to confirm the
request.
(If you wish to subscribe a different mail address then use:
'subscribe lhapdf-announce email@address ')
Downloading LHAPDF.
==================
From the LHAPDF web site ....http://projects.hepforge.org/lhapdf/
Installing LHAPDF.
=================
See the manual on the web site or the file INSTALL
Simplest way is:
configure --prefix=/where/you/want/it/to/go/
make
make install
Interfacing LHAPDF with your code.
=================================
LHAPDF is written is standard Fortran77 with double precision variables and v5.3.0
has been tested with the g77, f95 and gfortran compilers, and also with MacOSX.
Interfacing can be done in one of two ways:
1) directly using the LHAPDF routines
2) using the LHAGLUE interace to LHAPDF which provides a PDFLIB type access.
The main LHAPDF routines are:
call InitPDFset(name)
call InitPDF(mem)
call evolvePDF(x,Q,f)
call evolvePDFp(x,Q2,P2,IP2,f)
function alphasPDF(Q)
call GetLam4(mem,qcdl4)
call GetLam5(mem,qcdl5)
The main LHAGLUE routines are:
call PDFSET(parm,value)
call STRUCTM(X,Q,UPV,DNV,USEA,DSEA,STR,CHM,BOT,TOP,GLU)
call STRUCTP(X,Q2,P2,IP2,UPV,DNV,USEA,DSEA,STR,CHM,BOT,TOP,GLU)
call PDFSTA
Details of how to use these and many others are available in the on line manual
on the LHAPDF web site - http://projects.hepforge.org/lhapdf/
Interfacing LHAPDF with C++ code.
=================================
There is code within LHAPDF to interface with C++ programmes in the form of
a wrapper LHAPDFWrap. The code is downloaded in the tarball and built into
a wrapper library in the make install procedure. The wrapper code is also
available separately from the lhapdf web site http://projects.hepforge.org/lhapdf/
|