Pith. Sign in

REVIEW

THERMUS -- A Thermal Model Package for ROOT

High Energy Physics - Phenomenology · Submitted 15 Jul 2004 · 61 references

Pith's verdict: A solid, honestly documented tool paper whose headline feature — per-yield decay chains and efficiencies — is asserted but never actually exercised in the worked example.

T0 · AI review

How this review was made: An AI referee (selfhosted/deepseek-v4.1-flash) read the paper on November 11, 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 →

· 4 major objections · 8 minor · Ask about this paper · The compiled record · Read the full review →
Challenge this review Comment (0) Read on arXiv ↗
Cite ▾
arXiv IDhep-ph/0407174 (version 2)
Pith IDGSIXOFGL, Pith's permanent record of this paper and its review
CitationJ. Cleymans, M. Hauer, S. Wheaton. "THERMUS -- A Thermal Model Package for ROOT." arXiv:hep-ph/0407174 (2004). https://pith.science/paper/GSIXOFGL
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

A ROOT toolkit computes thermal-model particle yields in three statistical ensembles.

The reading

THERMUS is a C++ package that puts statistical-thermal-model calculations of particle production inside ROOT, the analysis framework used across heavy-ion physics. Its aim is to let a user start from a particle list and a set of thermal parameters, compute primordial densities and the feed-down from resonance decays, and then fit the thermal parameters to measured yields or ratios. The package implements three treatments of the conserved charges: grand-canonical baryon number, strangeness and charge; fully canonical conservation of all three; and a mixed case with strangeness conserved canonically while baryon number and charge remain grand-canonical. It also lets each experimental yield carry its own decay chain and detector efficiency, so feed-down corrections can match a particular data set. The paper's worked fit uses explicitly fictitious ratios, so the demonstration is of the workflow and the implementation of cited formalisms rather than a new comparison with measured data.

What carries the argument

The load-bearing mechanism is the ensemble-specific correction factor: in the canonical and strangeness-canonical treatments, the Boltzmann-approximation density, energy density and pressure of a species are the grand-canonical values with the canonically conserved chemical potential set to zero, multiplied by a factor such as $Z_{B-B_i,S-S_i,Q-Q_i}/Z_{B,S,Q}$ or $Z_{S-S_i}/Z_S$. THERMUS computes those factors, stores them in ensemble-specific thermal-model classes, and uses them to populate a hash table of densities keyed by PDG ID. Around that core it wraps particle and decay bookkeeping, a Broyden solver for constraints, and TMinuit for fits, with each yield able to point to its own particle set and decay chain.

Extended reading notes

Core claim

The paper's central claim is that a single ROOT-integrated package can carry out the full chain of a statistical-thermal analysis: define a hadron-resonance gas, choose an ensemble, compute primordial particle, energy, entropy densities and pressure, add resonance-decay contributions to stable particles, impose constraints such as $B/2Q$, strangeness or $E/N$, and fit thermal parameters to experimental yields with the ROOT implementation of MINUIT. The package is organised as a hierarchy of classes for particles, particle sets, parameter sets, thermal particles, thermal models and thermal fits, with ensemble-specific subclasses. Its practical contribution is not a new thermal-model formula but the assembly of the cited formulas into a reusable, interactive tool with per-yield decay chains and efficiency settings.

Load-bearing premise

The implementation reproduces the cited canonical and strangeness-canonical formalisms correctly, and the shipped default particle list, mass cutoff and rescaled branching ratios are adequate; the paper does not benchmark the package against measured yields, using fictitious ratios in its worked fit.

Editorial extensions

If this is right

  • A user can go from a particle list and trial thermal parameters to primordial densities, decay feed-down and fitted freeze-out parameters without leaving ROOT.
  • The same code base can treat high-energy collisions grand-canonically and low-energy collisions with strangeness treated canonically, so ensemble choices become a switch rather than a separate code.
  • Constraints on $B/2Q$, strangeness, $E/N$, total baryon density or $s/T^3$ can be imposed self-consistently while fitting, which makes the thermal parameters satisfy the collision's conservation conditions.
  • Quantum statistics, resonance width and excluded-volume corrections can be toggled, allowing systematic studies of how each effect changes the extracted parameters.
  • Per-yield decay chains and efficiencies let the model match the feed-down corrections of a specific experimental data set rather than a single universal chain.

Reading between the lines

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

  • If the package reproduces published fits, it could become a common baseline for comparing thermal-model results across experiments, provided the particle-list version and decay files are recorded with each fit.
  • The per-yield decay-chain machinery could be extended to propagate branching-ratio and efficiency uncertainties into the fitted parameters; the paper does not quantify that error budget.
  • A direct validation would be to recompute the canonical correction factors independently, for example by numerical integration of the partition-function integrals, and compare them with THERMUS across a grid of $T$, volume and chemical potentials.
  • Because the data structures already allow charm and beauty quantum numbers, extending the default particle list to charmed hadrons would let the same workflow test $\gamma_C$ at collider energies, although that extension is not demonstrated here.
Original abstract

THERMUS is a package of C++ classes and functions allowing statistical-thermal model analyses of particle production in relativistic heavy-ion collisions to be performed within the ROOT framework of analysis. Calculations are possible within three statistical ensembles; a grand-canonical treatment of the conserved charges B, S and Q, a fully canonical treatment of the conserved charges, and a mixed-canonical ensemble combining a canonical treatment of strangeness with a grand-canonical treatment of baryon number and electric charge. THERMUS allows for the assignment of decay chains and detector efficiencies specific to each particle yield, which enables sensible fitting of model parameters to experimental data.

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, 3,063 input tokens, $0.0001 reported.

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

The abstract, sentence by sentence

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

THERMUS is a package of C++ classes and functions allowing statistical-thermal model analyses of particle production in relativistic heavy-ion collisions to be performed within the ROOT framework of analysis. Calculations are possible within three statistical ensembles; a grand-canonical treatment of the conserved charges B, S and Q, a fully canonical treatment of the conserved charges, and a mixed-canonical ensemble combining a canonical treatment of strangeness with a grand-canonical treatment of baryon number and electric charge. THERMUS allows for the assignment of decay chains and detector efficiencies specific to each particle yield, which enables sensible fitting of model parameters to experimental data.

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 THERMUS is a package of C++ classes and functions allowing statistical-thermal model analyses of particle production in relativistic heavy-ion collisions to be performed within the ROOT framework of analysis. contribution 0.97 0.53 0.19 asserted 1.00
s1 Calculations are possible within three statistical ensembles; a grand-canonical treatment of the conserved charges B, S and Q, a fully canonical treatment of the conserved charges, and a mixed-canonical ensemble combining a canonical treatment of strangeness with a grand-canonical treatment of baryon number and electric charge. method 0.85 0.45 0.07 hedged possibility 0.59
s2 THERMUS allows for the assignment of decay chains and detector efficiencies specific to each particle yield, which enables sensible fitting of model parameters to experimental data. method 0.64 0.51 0.15 asserted 0.98

What kind of paper the classifier reports this is: method or tool 1.00 · evidence from simulation or computation 0.76.

What was examined, and what was not

sources read
  • arXiv listing abstract v2
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

Figures
Figure 1. The energy dependence of the decay contribution to th
Figure 2. The basic structure of THERMUS (only the most fundame
Figure 3. The mass distribution of the resonances included in

Figures reproduced from arXiv:hep-ph/0407174 by the authors.

References
How later papers used it

62 later papers cite it

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

Pith read 27 of the 88 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 12 of 25 papers with this label · 3 by the same authors

By the same authors

How the literature uses it

50 arXiv papers cite this in 72 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 whose main result relates to this one's

Found among the papers closest to this one by title and main claim. Pith's classifier compared each pair's main results and a second model family confirmed the relation; checked against two further families, shown conflicts agreed 118 times in 120 and shown same results 218 times in 239. The quoted sentence is the other paper's main claim.

States the same result 1 paper
  • THERMUS is a package of C++ classes and functions allowing statistical-thermal model analyses of particle production in relativistic heavy-ion collisions to be performed within the ROOT framework of analysis.

    THERMUS · 1.00

Papers citing it · 32 sentences without a confident label

Uses its method or tool 21 papers
Uses its data or values 4 papers
Compares with it 3 papers
Cites it as background 5 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.