AgentHEPGitHub ↗
Task suite v1

Tasks

Fourteen tasks in six tiers of increasing complexity. Every task has a specification, a data card, a reference implementation executed in the same sandbox as the agents, expected artifacts, numerical tolerances with a stated rationale, and a weighted rubric. Adversarial tasks plant documented traps.

TaskTierFamilyDataTrapsChecksSummary
t1-missing-audit1 · Inspectioninspectionsynth_jets · syntheticmissing_valuessentinel_valueduplicated_events13Count duplicates and missing values in a synthetic jet table whose data card documents a sentinel value and a known merge bug.
t1-schema-summary1 · Inspectioninspectioncms_dimuon_2011 · real13Load a real CMS open-data CSV and report its shape, columns and basic statistics of the dimuon mass.
t2-mass-histogram2 · Histograms & selectionshistogramscms_dimuon_2011 · real14Histogram the opposite-charge dimuon mass in a fixed binning, save the bin contents as JSON and a labelled SVG plot.
t2-selection-count2 · Histograms & selectionshistogramscms_dimuon_2011 · realempty_selection12Apply three kinematic selections to real CMS data and report yields; one selection is kinematically empty and must be flagged, not papered over.
t3-dimuon-kinematics3 · Derived variablesderived_variablescms_dimuon_2011 · real17Compute pair transverse momentum, rapidity, wrapped azimuthal separation and Delta-R per event from CMS four-vectors.
t3-invariant-mass3 · Derived variablesderived_variablessynth_zmumu · synthetic15Build four-vectors from (pt, eta, phi) and the muon mass, compute the pair mass for 50k synthetic events, and summarise the Z window.
t3-unit-mismatch3 · Derived variablesderived_variablessynth_jets · syntheticunit_mismatchduplicated_eventsmissing_values14Aggregate a long-format jet table to per-event quantities; requires de-duplication, NaN handling and a MeV-to-GeV conversion documented in the data card.
t4-cut-optimization4 · Signal / backgroundsignal_backgroundsynth_sigbkg · syntheticnormalisation15Scan a threshold on missing transverse energy, normalise weighted yields to cross-section times luminosity, and report the best cut.
t4-feature-separation4 · Signal / backgroundsignal_backgroundsynth_sigbkg · syntheticlabel_leakage20Compute the ROC AUC of each physics observable in a labelled table, rank them, overlay the best one; a bookkeeping column leaks the label and must be excluded.
t5-bump-fit5 · Statisticsstatisticssynth_diphoton · synthetic17Binned least-squares fit of signal + background to a diphoton mass spectrum with a fully specified model, binning and initial values.
t5-bump-significance5 · Statisticsstatisticssynth_diphoton · synthetic17Estimate the background under a mass window from an unbinned exponential fit to the sidebands and quantify the excess with an Asimov formula and an exact Poisson p-value.
t5-low-stats5 · Statisticsstatisticssynth_diphoton_lowstat · syntheticinsufficient_statistics17Same recipe as the significance task on a 43-event file: must flag low statistics, use the exact Poisson p-value and not over-claim.
t6-broken-pipeline6 · Multi-step & debuggingdebuggingsynth_zmumu · syntheticschema_changesilent_exceptionunit_mismatchformula_bug15An existing dimuon-mass pipeline crashes and, once it runs, gives wrong numbers; the agent must diagnose four planted bugs (schema rename, wrong formula, wrong unit conversion, swallowed exception) and deliver correct artifacts.
t6-full-analysis6 · Multi-step & debuggingend_to_endcms_dimuon_2011 · real20Quality selection, mass histogram, specified signal+background fit, efficiency bookkeeping, and a written report with stated assumptions, all in one reproducible script.

Datasets

cms_dimuon_2011real

100,000 dimuon events from the CMS 2011 DoubleMu primary dataset (CERN Open Data record 545). Each row is one event with two reconstructed muons and their invariant mass M in GeV.

CC0 1.0 (CERN Open Data Portal) · source · sha256 58caa45c580f…
synth_zmumusynthetic

50,000 synthetic dimuon events: Z->mumu (Breit-Wigner x 1.2 GeV Gaussian resolution) on an exponential continuum. Muon kinematics only; no mass column.

CC0 (generated) · seed 20260905 · sha256 9781b3d34c9a…
synth_jetssynthetic

Long-format jet table for 20,000 events with planted traps: NaN pt, -999 eta sentinel, duplicated rows, MeV energy column.

CC0 (generated) · seed 20260906 · sha256 02087c7e88a3…
synth_sigbkgsynthetic

40,000 labelled signal/background events with six physics observables, a generator weight and a label-leaking bookkeeping column.

CC0 (generated) · seed 20260907 · sha256 2b50eb1810b0…
synth_diphotonsynthetic

Diphoton mass spectrum 100-180 GeV: 30,000 exponential-background events plus a 300-event Gaussian bump at 125 GeV.

CC0 (generated) · seed 20260908 · sha256 d3471a0dc653…
synth_diphoton_lowstatsynthetic

Same model as synth_diphoton with only 40 background and 3 signal events: a low-statistics trap.

CC0 (generated) · seed 20260909 · sha256 340e98d945d8…