Chemistry · Lesson
Benchmarking, uncertainty and reproducible chemical computation
Test what a computational result establishes through subgroup benchmarks, numerical error models, reproducible records and correlated uncertainty.
Back to the Chemistry mapBy the end, you can
- Compare subgroup and weighted benchmark errors.
- Apply extrapolation only under its declared error model.
- Check units and explicit geometry transformations separately from byte identity.
- Propagate a difference using the stated covariance.
A benchmark must match the scientific question
Choose a reference relevant to the intended property, chemical states and conditions. Experimental observations and other calculations can both have uncertainty and known limitations. A benchmark set should make its coverage and exclusions visible.
An aggregate comparison measures performance on that set. It does not prove exactness or superiority for every untested chemical system. Report different regimes when their errors or requirements differ.
A benchmark and a convergence check test different things
A pooled benchmark weights its subgroups by their representation. Changing those weights can reverse a method ranking even when every subgroup error remains unchanged. Report the intended target mixture and subgroup performance instead of treating one pooled score as a universal ordering.
A numerical extrapolation uses a model of discretization error. The assigned h² function below gives a difference ratio four and an exact order-two extrapolation. Adding an h⁴ term leaves a small residual under the same rule, showing why the error form matters. Neither calculation validates a chemical approximation.
Reference data also have defined states, conditions and uncertainty. Agreement can be meaningful only after those conventions and the numerical comparison are made compatible. A successful reproducibility check establishes a particular result under a particular method, rather than correctness for all systems.
Weighted MAE / kJ mol⁻¹
Rare-regime weight w
- Assigned method A
- Assigned method B
- — Assigned A weighting
Underlying data
| Rare-regime weight w | Weighted MAE / kJ mol⁻¹ |
|---|---|
| 0.2 | 2 · Assigned method A |
| 0.4 | 3 · Assigned method A |
| 0.5 | 3.5 · Assigned method A |
| 0.2 | 2.2 · Assigned method B |
| 0.4 | 2.4 · Assigned method B |
| 0.5 | 2.5 · Assigned method B |
Original assigned subgroup MAEs: method A has common/rare errors 1/6 and B 2/3 kJ mol⁻¹. Weighted A=1+5w and B=2+w for rare-regime weight w. Circles and squares mark w=0.20,0.40,0.50; the dashed curve evaluates A. No actual named method is ranked.
Numerical reproducibility and scientific validity are different checks
Reproducing the same output can test implementation and recorded inputs. Changing appropriate numerical settings can test convergence. Comparing with suitable independent evidence tests another part of the scientific model.
Identical output from the same assumptions does not establish that those assumptions represent the real system. Conversely, small numerical differences between implementations need interpretation against the target tolerance and scientific uncertainty.
A reproducible record preserves inputs and transformations
Retain chemical identities, coordinates, units, model and parameter versions, algorithm settings, data transformations and relevant random choices. Record which result came from which exact input rather than relying on a descriptive filename alone.
Preserve failures, exclusions and unresolved alternatives where they affect interpretation. An automated result should carry enough context for another reader to assess the claim and repeat the relevant computation.
A useful computational conclusion states its tested scope
Connect the model output to the observation or relationship it explains. Separate fitted evidence from held-out evaluation, numerical tolerance from model uncertainty, and a prediction from a demonstrated result.
The original verification cases below use fully specified invented quantities. They illustrate reproducible reasoning and limited inference without certifying an actual computational method for every chemical application.
Worked examples
A benchmark mixture can change the ranking
Invent reaction-energy residuals for two methods A/B in two regimes. Eight common-regime rows have alternating residuals ±1 for A and ±2 for B; two rare-regime rows have ±6 for A and ±3 for B, all kJ mol⁻¹. Compare pooled and equally weighted regime MAEs.
- Common-regime MAEs are one and two; rare-regime MAEs six and three. Both methods have signed bias zero in each balanced ± account, which does not make their error magnitudes equal.
- The ten-row benchmark weights the rare regime by 0.200. Weighted MAE_A=0.800×1+0.200×6=2.00; MAE_B=0.800×2+0.200×3=2.20 kJ mol⁻¹.
- Weighting the two regimes equally instead gives 3.50 for A and 2.50 for B. The ranking changes because the target mixture changes.
- These invented scores establish no superiority of a named actual method. A comparison should report subgroup performance and the population for which weights are meaningful.
A has lower pooled MAE in the 80/20 mixture; B has lower MAE with equal regime weights.
Extrapolation uses an assumed error form
Assign Q(h)=Q₀+ah² with Q₀=−18.750 kJ mol⁻¹, a=120 kJ mol⁻¹ nm⁻² and h=0.080,0.040,0.020 nm. Find the order-two extrapolation from the latter pair.
- Assigned values are −17.982, −18.558 and −18.702 kJ mol⁻¹. Successive differences are −0.576 and −0.144, giving magnitude ratio four, as expected from this exact quadratic law.
- Q_extrap=Q(h/2)+[Q(h/2)−Q(h)]/3=−18.702+(−18.702+18.558)/3=−18.750 kJ mol⁻¹.
- The fine value’s known error is +0.0480 kJ mol⁻¹. The limit is known because the complete toy function is assigned. Actual extrapolation depends on reaching the relevant error regime and does not validate the physical model.
The assumed order-two rule returns −18.750 kJ mol⁻¹ for this exact stipulated law.
Different bytes can encode the same declared geometry
Assign neutral singlet ethanenitrile C₂H₃N with bonds N1≡C1−C2 and three C2−H bonds. In record A, nanometre coordinates are N1(0,0,0), C1(0.116,0,0), C2(0.263,0,0), H1(0.300,0.090,0), H2(0.300,−0.045,0.07794228634), H3(0.300,−0.045,−0.07794228634). Record B stores the same identified atoms after translation by (1.20,−0.400,0.750) nm and conversion to ångströms. What comparison is appropriate?
- The declared inventory has six atoms, charge zero and 2×6+3+7=22 electrons. Its selected multiplicity is one. These coordinates are invented, without a claim of optimized actual geometry.
- The N1−C1 distance is 0.116 nm; C1−C2 is 0.147 nm. Each C2−H distance is √(0.037²+0.090²)=0.0973087869 nm; the other two H vectors give the same distance.
- For every atom r_B/10=r_A+(1.20,−0.400,0.750) nm. Taking differences cancels the translation, so all pair distances agree under the declared unit conversion. Identity, charge, spin and bonds must also be checked.
- A hash of each exact encoded record can differ because its numbers, units and text differ. Hash equality identifies byte equality under its hashing convention; scientific equivalence here follows from the explicit transformation, not a hash or familiar filename.
Different encodings; matching declared identity and all pair distances after the explicit conversion and translation.
Shared uncertainty can partly cancel in a difference
Assign compatible energy estimates E_A=−34.20 and E_B=−37.65 kJ mol⁻¹, standard uncertainties u_A=0.800 and u_B=1.10 kJ mol⁻¹, and correlation ρ=0.600. Choose coverage factor k=2. Find Δ=E_B−E_A and its propagated uncertainty.
- Δ=−3.45 kJ mol⁻¹. Covariance is ρu_Au_B=0.528 (kJ mol⁻¹)².
- For this linear difference, u²(Δ)=u_A²+u_B²−2ρu_Au_B=0.640+1.210−1.056=0.794 (kJ mol⁻¹)². Thus u(Δ)=0.891066776 kJ mol⁻¹.
- With the chosen k=2, expanded uncertainty U=1.78213355 kJ mol⁻¹. Assuming zero correlation instead would give u=√1.85=1.36014705 kJ mol⁻¹.
- The propagation is exact for the linear difference and supplied covariance; adequacy of the uncertainty estimates is separate. k=2 alone does not establish 95% coverage without relevant distribution and degrees-of-freedom assumptions, or bound omitted systematic chemistry errors.
Δ=−3.45 kJ mol⁻¹, standard uncertainty 0.891066776 and chosen expanded uncertainty 1.78213355 kJ mol⁻¹.
Try it yourself
Use a future benchmark mixture with 40% rare-regime weight and 60% common-regime weight, holding the assigned subgroup MAEs fixed. Find both weighted MAEs.
Show the answer and reasoning
A=3.00 and B=2.40 kJ mol⁻¹; B has lower weighted MAE in the assigned future mixture.
The new target mixture weights the difficult regime more strongly, reversing the original pooled ranking.
Add b h^4 with b=900 kJ mol-1 nm-4 to the same toy law. Use h=0.040/0.020 nm and the same order-two extrapolation. Find the extrapolated value and its residual error.
Show the answer and reasoning
Coarse −18.555696, fine −18.701856; extrapolated −18.750576 kJ mol⁻¹, residual error −0.000576 kJ mol⁻¹.
The added fourth-order term is not fully removed by the order-two extrapolation.
If A numerical coordinates are copied unchanged but labelled angstrom instead of nm, find the interpreted N-C and C-C distances in nm.
Show the answer and reasoning
Interpreted N−C=0.0116 nm and C−C=0.0147 nm, one tenth of A.
Interpreting the numbers as angstrom applies a factor 0.100 to their nanometre distances.
Keep all inputs except correlation = -0.300. Find u(Delta) and U for the same k = 2.
Show the answer and reasoning
u(Δ)=1.54207652 and U=3.08415304 kJ mol⁻¹.
Negative covariance increases the variance of this difference; shared errors can partly cancel when correlation is positive.
What to carry forward
- A benchmark ranking depends on the target population and subgroup weights.
- Extrapolation relies on an error model and does not validate chemistry by itself.
- Byte identity, geometric equivalence and scientific accuracy are separate checks.
- Include covariance when reporting the uncertainty of a difference.
References
Teaching resources and reference material supporting this lesson’s explanations and examples.
- CP2K: How to converge CUTOFF and REL_CUTOFFCP2K developer documentation; original tutorial maintained by Ole SchüttSource
- OECD principles for validation of (Q)SAR modelsOECD member-country joint Chemicals Committee/Working PartySource · PDF
- Reproducibility in density-functional theory calculations of solidsKurt Lejaeghere, Stefaan Cottenier and multinational code-developer/expert-user coauthorsSource
- The FAIR Guiding Principles for scientific data management and stewardshipMark D. Wilkinson and international FAIR coauthorsSource
- PubChemQC project: selected calculation conditions and archived input/output provenanceMaho Nakata, Tomomi Shimazaki, Toshiyuki Maeda, Masatomo HashimotoSource
- JCGM 100:2008 — Guide to the expression of uncertainty in measurementJoint Committee for Guides in MetrologySource · PDF