Benchmark Card
A benchmark card records what a benchmark actually tests before using it to support a paper claim. It is the paper-reading counterpart of a dataset card.
A benchmark can be summarized as:
is data, is task, is split policy, is metric, and is preprocessing or protocol.
Use Benchmark intake before writing the card. The intake pass decides whether the reported score is testing the paper’s stated claim or only a narrower interpolation setting.
Fields
- Task: what input-output mapping is evaluated.
- Data source: public dataset or benchmark origin.
- Unit of prediction: molecule, protein, complex, sequence, image, document, or run.
- Split: random, scaffold, protein-family, temporal, source, or held-out target.
- Metric: what number decides success.
- Baseline: what comparison makes the metric meaningful.
- Leakage risks: entity overlap, template leakage, duplicate records, or label leakage.
- Contamination risks: pretraining, retrieval, prompt, feature, model-selection, or leaderboard feedback overlap.
- Saturation status: whether score differences still exceed metric noise.
- Scope: what deployment or scientific claim the benchmark can and cannot support.
Claim Fit
Benchmark cards should explicitly map score to claim:
| Paper claim | Benchmark must show |
|---|---|
| better generalization | split blocks the claimed shortcut |
| better ranking | candidate set and ranking metric match use case |
| better calibration | probability metric and calibration check |
| better generation | validity, novelty, diversity, and task utility |
| better efficiency | latency, throughput, memory, or cost under comparable hardware |
| better scientific fidelity | domain-specific validity checks, not only generic ML metrics |
If the benchmark does not test the claim, route the result to a narrower note instead of repeating the broad claim.
Benchmark Identity
The same benchmark name can hide protocol differences:
Record enough detail to distinguish dataset version, split files, preprocessing, metric implementation, and excluded examples.
Checks
- Does the split match the generalization claim?
- Does the metric match the task objective?
- Are preprocessing and filtering choices stated?
- Is the final test set protected from contamination?
- Is the benchmark saturated or still discriminative?
- Can a simple baseline expose shortcut learning?
- Are benchmark version and split files identifiable?
- Does the benchmark measure the decision the system will actually make?