REVIEW
The Les Houches Accord PDFs (LHAPDF) and Lhaglue
High Energy Physics - Phenomenology · Submitted 9 Aug 2005 · 22 references
Pith's verdict: A concrete, honest user note for LHAPDF 4.1 and LHAGLUE, whose one load-bearing claim — functional equivalence to PDFLIB — is asserted rather than demonstrated.
T0 · AI review
Why Pith says this
Highlight any text to comment on it.
Referee report
The paper
The paper claims
LHAPDF is presented as a working replacement for PDFLIB, the long-standing Fortran library of parton density functions, with a look-alike interface that lets PYTHIA and HERWIG switch to it without source changes.
The reading
What carries the argument
The load-bearing mechanism is the separation of compiled code from PDF data, combined with the 'set' abstraction and a compatibility shim. In PDFLIB the interpolation grids and routines were effectively one compiled Fortran object; in LHAPDF the code is fixed and each PDF set is a small external file whose contents decide whether the analytic-plus-evolution route or the stored-grid route is used. Because a whole set is initialised at once, switching between the members of an error set carries no re-initialisation cost — the paper notes that the analytic route's initialisation can take around two seconds per member on a 1 GHz machine, which motivated the grid option. LHAGLUE then wraps this behind three subroutines, PDFSET, STRUCTM and STRUCTP, whose signatures mirror PDFLIB's, with control switches in the LHAPARM character array governing path lookup, out-of-range statistics, whether the generator adopts LHAPDF's $alpha_s$, boundary extrapolation versus freezing, and print verbosity. The user links $libLHAPDF.a$ in place of PDFLIB and renames the dummy STRUCTM, STRUCTP and PDFSET stubs exactly as they would for PDFLIB.
Extended reading notes
Core claim
The authors report that LHAPDF has reached the point where it can be called a functional replacement for PDFLIB, and that LHAGLUE supplies PDFLIB look-alike access so that existing Monte Carlo generators such as PYTHIA and HERWIG can use it through their existing PDFLIB hooks with no changes to their source. Two design choices carry that claim. First, the PDFs live in small external parameter or grid files rather than being compiled into the library, so new sets can be added without rebuilding the code; both an analytic-parameter route ('.LHpdf', with evolution performed on request by EVLCTEQ or QCDNUM) and a grid route ('.LHgrid', with the authors' own interpolation code) are supported behind one identical calling sequence. Second, a 'set' is a related collection of PDFs initialised together, which is what makes the multi-member error sets usable — the very thing PDFLIB could not accommodate. The paper records the release history (V1 by Giele in 2002, V2 in March 2004 adding legacy grid sets, V3 in September 2004 adding LHAGLUE plus ZEUS and H1 sets, V4 in March 2005 adding photon and pion PDFs, V4.1 in August 2005 standardising installation), tabulates the proton, pion and photon sets with their LHAGLUE numbers, and states that the interface has been tested at Tevatron and LHC energies for proton PDFs and with HERA examples for photon PDFs.
Load-bearing premise
The load-bearing premise is that LHAPDF's numbers agree with PDFLIB's, and with the generators' own internal PDF codes, closely enough that swapping one for the other changes nothing a physics analysis would notice — a premise the paper supports by assertion and by pointing to a validation note still in preparation, while footnote 1 separately records a known discrepancy of up to about 0.5% between LHAPDF's MRST output and the MRST authors' own code, attributed to grid boundary mismatches at heavy quark thresholds.
Editorial extensions
If this is right
- New or revised parton density sets, including the large error ensembles that PDFLIB could not represent, can be distributed as data files and picked up by existing generator installations without recompiling the library.
- PYTHIA and HERWIG users obtain the newest fits and their uncertainty members through the same PDF numbering and hook mechanism they already use, so systematic studies of PDF uncertainty become a configuration choice rather than a code change.
- Photon and pion PDFs, previously reachable only through PDFLIB, are available on the same footing, which matters for two-photon and pion-induced processes at HERA and the LHC.
- Because $alpha_s$ can be taken from LHAPDF and used inside the generator as well, a single consistent coupling runs through the hard matrix element and the parton shower for a given set.
- The stated next step is to allow more than one PDF set to be initialised concurrently, which is needed when the two beams are of different particle types or when photon and pion PDFs are mixed in.
Reading between the lines
- The paper's real test is not whether LHAPDF returns numbers, but whether a physics analysis run end-to-end through LHAPDF reproduces the same cross sections as one run through PDFLIB within the statistical and systematic precision of the measurement — a standard the paper describes as met but does not demonstrate in its own pages.
- The design choice to keep analytic parameterisations as a first-class route alongside stored grids means the library is only as trustworthy as the evolution codes it borrows; any disagreement between EVLCTEQ or QCDNUM and a PDF group's own evolution would show up as a set-dependent offset rather than a uniform one, which is the kind of effect a per-set validation table would reveal.
- The multi-set abstraction described here anticipates the later practice of treating PDF uncertainty as a first-class nuisance parameter in LHC analyses; the concrete enabler is the cheap switching between members, not the file format itself.
Original abstract
We describe the development of the LHAPDF library from its initial implementation following the Les Houches meeting in 2001 to its present state as a functional replacement for PDFLIB. Brief details are given of how to install and use the library together with the PDF sets available. We also describe LHAGLUE, an add-on PDFLIB look-a-like interface to LHAPDF, which facilitates using LHAPDF with existing Monte Carlo generators such as PYTHIA and HERWIG.
The compiled record
The paper's own sentences, arranged, kept beside the review and separate from it. Each label is drawn from a closed vocabulary; the number beside it is the probability the classifier gave that label. Numbers in the tables are the authors', checked by code. No sentence in this record was written by a model.
The abstract, sentence by sentence
We describe the development of the LHAPDF library from its initial implementation following the Les Houches meeting in 2001 to its present state as a functional replacement for PDFLIB. Brief details are given of how to install and use the library together with the PDF sets available. We also describe LHAGLUE, an add-on PDFLIB look-a-like interface to LHAPDF, which facilitates using LHAPDF with existing Monte Carlo generators such as PYTHIA and HERWIG.
background contribution method result interpretation main claim
| # | sentence | role | the authors' own work | states the main conclusion | strength |
|---|---|---|---|---|---|
| s0 | We describe the development of the LHAPDF library from its initial implementation following the Les Houches meeting in 2001 to its present state as a functional replacement for PDFLIB. | contribution 0.95 | 0.68 | 0.35 | asserted 1.00 |
| s1 | Brief details are given of how to install and use the library together with the PDF sets available. | method 0.79 | 0.38 | 0.05 | asserted 0.95 |
| s2 | We also describe LHAGLUE, an add-on PDFLIB look-a-like interface to LHAPDF, which facilitates using LHAPDF with existing Monte Carlo generators such as PYTHIA and HERWIG. | contribution 0.98 | 0.81 | 0.11 | asserted 1.00 |
What was examined, and what was not
- arXiv listing abstract v1
- full text
- figures and tables
- references and citing sentences
- relations to other papers
- P abstract
- S sections
- T body sentences
- C citations
- R cross-paper relations
References
How later papers used it
196 later papers cite it
14 later papers by other authors are listed below: 14 used its method or tool.
Uses its method or tool 14 of 150 papers with this label
-
To simulate the Lambda production in electron-proton scattering, event generator PYTHIAeRHIC [ref] , a modified version of PYTHIA6.4.28 [ref] , is used with the Parton Distribution Functions (PDFs) input from LHAPDF [ref] .
Lambda polarization at Electron-ion collider in China (2023) · Simulation Framework · 1.00
-
Used unpolarized PDF input from the LHAPDF library to generate pseudo-data with the PYTHIA-6 Monte Carlo generator.
Photon structure studied at an Electron Ion Collider (2017) · 1.00 · paraphrased: the licence does not allow quoting
-
Calculated ZZ and WZ cross sections using PDFs from the LHAPDF program, version 5.8.7.
Measurements of the ZZ production cross sections in the 2 l 2 nu channel in proton-proton collisions at sqrt(s) = 7 and 8 TeV and combined constraints on triple gauge couplings (2015) · 0.99 · paraphrased: the licence does not allow quoting
-
Used the leading order MSTW2008LO68cl parametrization available through the LHAPDF library, version 5.8.4, for its collinear PDFs.
Description of fully differential Drell-Yan pair production (2011) · 0.86 · paraphrased: the licence does not allow quoting
-
Ran mcfm at NLO using the lhapdf (v5.8.8) interface for four modern NLO PDF sets to examine boson pT distributions and cross-section ratios.
Ratios of $W$ and $Z$ cross sections at large boson $p_T$ as a constraint on PDFs and background to new physics (2013) · 1.00 · paraphrased: the licence does not allow quoting
-
In the default JEWEL configuration, the jet production matrix elements and initial parton showers are simulated using central EPS09 LO nuclear PDFs (nPDFs) [ref] , based on CTEQ6L1 free proton PDFs [ref] and provided through the LHAPDF5 interface [ref] .
Impact of scale, nuclear PDF and temperature variations on the interpretation of medium-modified jet production data from the LHC (2020) · Nuclear PDFs · 0.94
-
Obtained PDF uncertainty from the PDF error sets using the LHAPDF library.
Strong coupling constant extraction from high-multiplicity Z+jets observables (2017) · 1.00 · paraphrased: the licence does not allow quoting
-
To normalize the simulated signal samples to the data, next-to-next-to-leading-order (NNLO) and next-to-next-to-leading-logarithmic (NNLL) soft-gluon resummation cross sections are obtained using the Top++ program (v.2.0) [ref] , with the MSTW2008NNLO68CL PDF set as implemented in the LHAPDF (v.5.9.0) framework [ref] .
Search for vector-like quarks in events with two oppositely charged leptons and jets in proton-proton collisions at $\sqrt{s} =$ 13 TeV (2018) · The CMS detector and event simulation · 0.96
-
Based its ep event simulation on the PYTHIA eRHIC Monte Carlo program with PDFs input from the LHAPDF library.
Transverse Lambda production at the future Electron-Ion Collider (2021) · 1.00 · paraphrased: the licence does not allow quoting
-
Used the LHAPDF package of PDFs in its simulation of spectra from Z leptonic decays.
\Delta M_W < 10 MeV/c^2 at the LHC: a forlorn hope? (2010) · 0.99 · paraphrased: the licence does not allow quoting
-
Used the MSTW2008 parametrization of PDFs implemented in LHAPDF in its computation with factorization and renormalization scales set equal to mh.
Electroweak Symmetry Breaking via QCD (2014) · 0.90 · paraphrased: the licence does not allow quoting
-
Compared NLO and NNLO predictions for benchmark processes using PDFs available through the current lhapdf V5.8.5 interface.
Parton distribution function dependence of benchmark Standard Model total cross sections at the 7 TeV LHC (2011) · 1.00 · paraphrased: the licence does not allow quoting
-
Used the MSTW2008NLO PDF set provided in LHAPDF5 in its fit and event generation codes for quarkonium production.
Feasibility studies for quarkonium production at a fixed-target experiment using the LHC proton and lead beams (AFTER@LHC) (2015) · 1.00 · paraphrased: the licence does not allow quoting
-
Ran Pythia 8.145 with CTEQ6.5 PDFs obtained via LHAPDF for LHC analyses.
Light Stop NLSPs at the Tevatron and LHC (2011) · 1.00 · paraphrased: the licence does not allow quoting
How the literature uses it
196 arXiv papers cite this in 234 sentences
Papers citing it · 58 sentences without a confident label
Uses its method or tool 150 papers
-
To simulate the Lambda production in electron-proton scattering, event generator PYTHIAeRHIC [ref] , a modified version of PYTHIA6.4.28 [ref] , is used with the Parton Distribution Functions (PDFs) input from LHAPDF [ref] .
Lambda polarization at Electron-ion collider in China · Simulation Framework · 1.00
-
In this paper, we use pseudo-data generated by the Monte Carlo generator PYTHIA-$6$ [ref] , with the unpolarized PDF input from the LHAPDF library [ref] .
Photon structure studied at an Electron Ion Collider · Monte Carlo Set Up · 1.00
-
As will be explained below, the tool which we propose is based on HELAC-Onia [ref] (but is not restricted to quarkonia) can use any nPDF set included in the library LHAPDF5 [ref] and LHAPDF6 [ref] and does not rely on any model for the hard-probe production, but on $pp$ measurements which are used to tune the partonic scattering elements.
Towards an automated tool to evaluate the impact of the nuclear modification of the gluon density on quarkonium, D and B meson production in proton-nucleus collisions · Introduction · 0.99
Cites it as background 4 papers
-
When particle physicists found themselves in a similar situation regarding collider related calculations, they created a series of interfaces that allowed their various tools to communicate with each other [ref] .
Les Houches 2011: Physics at TeV Colliders New Physics Working Group Report · INTRODUCTION · 0.85
-
Nonetheless, a standard format [ref] was agreed to be used by the community: PDF measurements are presented in grids of values as functions of momentum fraction $x$ of a parton with flavor $a$ and energy scale $Q$; collections of such grids are usually called PDF sets.
PDFFlow: hardware accelerating parton density access · Introduction and motivation · 0.80
-
Therefore, the first versions of the LHAPDF software [ref] tackled the issue proposing to store only PDF starting values at low $Q^2$ scale and evolving them through the DGLAP equation to reach high energies.
Deep Learning Applications to Particle Physics: from Monte Carlo simulation acceleration to ProtoDUNE reconstruction · LHAPDF: the Les Houches Accord PDF · 0.90
Discussion
Disagree with the review, or know something it missed? Leave a comment, highlight any passage above to comment on it, or challenge this review formally.