Pith. Sign in

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

How this review was made: An AI referee (selfhosted/deepseek-v4.1-flash) read the paper on October 29, 2026 and answered a fixed list of questions about it. T0 is the starting level every paper gets. The levels describe how deeply Pith has checked the paper, never the authors.

  1. T0 AI review An AI read the paper and answered a fixed list of questions.
  2. T1 Audit Automatic checks that the references and files the paper relies on exist and match.
  3. T2 Compute The paper's code or calculations re-run with the same results.
  4. T3 Formal statement The claims written out in a formal math language a computer can read.
  5. T4 Proof Those claims proved, and the proof checked by computer.

How Pith checks papers →

· 3 major objections · 7 minor · Ask about this paper · The compiled record · Read the full review →
Challenge this review Comment (0) Read on arXiv ↗
Cite ▾
arXiv IDhep-ph/0508110 (version 1)
Pith IDRXZEW5WN, Pith's permanent record of this paper and its review
CitationD.Bourilkov, M.R.Whalley, R.C.Group. "The Les Houches Accord PDFs (LHAPDF) and Lhaglue." arXiv:hep-ph/0508110 (2005). https://pith.science/paper/RXZEW5WN
Cite this reviewBibTeX for Pith's review of this paper
Claim paper

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

Parton density functions — the tables that say how likely a quark or gluon is to carry a given fraction of a proton's momentum — were long distributed through a single Fortran library, PDFLIB, with the interpolation grids baked into the compiled code. That arrangement could not absorb the new generation of uncertainty sets, which arrive as twenty to forty closely related members that a simulation has to switch between cheaply. The paper's claim is that LHAPDF, grown out of a proposal at a 2001 workshop and refined through four releases, now stands in PDFLIB's place: it keeps the PDFs as separate data files, loads an entire set in one go, and ships LHAGLUE, a thin shim whose subroutine calls match PDFLIB's closely enough that PYTHIA and HERWIG link against it through their existing hooks. If that holds, the practical consequence is that the LHC simulation chain can adopt the newest fits and their error members without anyone rewriting the event generators. The paper is a status and usage report rather than a measurement, and its evidence for the phrase 'functional replacement' is the statement that comparisons were made, with the numbers deferred to a companion note.

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

Editorial extensions of the paper, not claims the author makes directly.

  • 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.

Compiled by classifier-1.13-20260917 via OpenRouter, question bank abstract-p1-20260923, 2026-09-23: 1 request, 2,963 input tokens, $0.0001 reported.

What the abstract itself states, as probabilities: claims first 0.05 · states limitation 0.07 · human participants 0.02 · controlled comparison 0.04 · randomized assignment 0.01 · states quantitative result 0.05 · compares with prior results 0.62 · mentions code or data availability 0.67.

The abstract, sentence by sentence

arXiv listing abstract v1. Results and the main claim are underlined; .

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

What the classifier reports for each sentence. The number is the probability it gave the label.
#sentencerolethe authors' own workstates the main conclusionstrength
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 kind of paper the classifier reports this is: method or tool 1.00 · evidence from argument 0.92.

What was examined, and what was not

sources read
  • arXiv listing abstract v1
not examined
  • full text
  • figures and tables
  • references and citing sentences
  • relations to other papers
levels run
  • P abstract
not run
  • S sections
  • T body sentences
  • C citations
  • R cross-paper relations

Every quoted sentence on this record is the authors'. Every label is from Pith's closed vocabulary, with the probability shown beside it. Every number in the measurements table is the authors', checked by code. Record as JSON

References
How later papers used it

196 later papers cite it

Evidence: substantial. 195 of the citing papers share no author with it, and 149 of those carry a confident label from Pith's citation classifier.

Pith read 27 of the 233 citing sentences, choosing only those whose citation markers point at this paper alone, and wrote the paraphrases from them. The summary, the counts, the evidence level, the links and the quotes come from code; the summary counts the papers listed below. A later paper is listed under a label when Pith's citation classifier gives one of its sentences that label at probability 0.8 or more (0.95 for support), Pith's reading finds that the citing paper itself did it, and a second check confirms the paraphrase against the sentence. This section lists uses only. It does not list criticism or disagreement, so their absence here says nothing about how the paper has been received. Papers that share an author with this one are listed apart, under "By the same authors". A quote is the citing authors' own sentence, shown when their paper's licence is CC BY, CC BY-SA or CC0. JSON

Uses its method or tool 14 of 150 papers with this label
How the literature uses it

196 arXiv papers cite this in 234 sentences

Each citing sentence is taken from the citing paper's LaTeX source and typed by Pith's classifier. A label appears at probability 0.8 or more (0.95 for support), a contest at 0.7 or more; the quoted words are the citing authors'. How each label was checked · JSON

Papers citing it · 58 sentences without a confident label

Uses its method or tool 150 papers
Cites it as background 4 papers

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.