One arena, many causal discovery regimes.
CausalArena benchmarks tabular causal discovery across synthetic, semantic, formula-grounded, and real-data tracks under shared observational and mixed-interventional protocols. This dashboard separates accuracy, structural error, runtime, scaling, and graph-level inspection so method behavior stays diagnosable beyond one pooled score.
What the arena is designed to test
CausalArena is built around four requirements for causal discovery evaluation in the foundation-model era: broad causal-environment coverage, refreshable benchmark content, grounded causal meaning, and diagnosable failure profiles beyond a single pooled score.
How to read the dashboard
Use the shared navigation panel for the main leaderboard, semantic/formula case analysis, SCM library, real-data checks, scaling curves, runtime summaries, method metadata, and submission instructions.
Benchmark composition
| Track | Scope | Ground truth | What it reveals |
|---|---|---|---|
| Synthetic SCMs | Controlled variation over graph families, mechanisms, root/noise distributions, dimensions, sample sizes, and intervention designs. | Executable DAG + mechanisms | How methods respond to isolated structural and statistical shifts. |
| Semantic operational SCMs | 10 operational domains: cybersecurity and IT operations, education, finance and credit, government services, healthcare delivery, housing and real estate, manufacturing, public health, urban transportation, and water and sanitation. | Executable DAG + variable/edge semantics | Whether methods recover meaningful operational chains, proxies, bottlenecks, and measurement channels. |
| Formula-grounded SCMs | 10 scientific domains: biology and ecology, astronomy, chemistry, mechanics and fluids, earth systems, electromagnetism, energy systems, materials and structures, optics and waves, and thermodynamics. | Executable DAG + equations/ranges | Whether methods handle explicit scientific mechanisms, units, residuals, validity ranges, and equation-level interactions. |
| Real-data check | Public scored tabular sources: CD-CSG, Sachs flow cytometry, PetShop telemetry, and Causal Chamber physical systems. | Known directed graphs from sources | Whether wrappers still recover known graphs on public real tables outside the generated SCM arena. |
Mechanism and distribution taxonomy
This section summarizes the actual category vocabulary present in the current release artifacts. Synthetic categories are read from the generated factor metadata; Semantic and Formula categories are read from the released grounded SCM records. Bars show proportions within the currently released subset where reliable per-category counts are available.
Synthetic SCMs
Controlled generated SCMs with explicit factor axes.
All edge mechanisms (16)
All noise families (14)
All root distributions (14)
Semantic operational SCMs
Domain-grounded operational graphs; counts below are from released Semantic graph artifacts.
All edge mechanism categories (60)
Formula-grounded SCMs
Scientific equation-grounded graphs; counts below are from released Formula graph artifacts.
All edge mechanism categories (87)
All formula families (50)
A/B leaderboard
The main table reports aggregate F1/SHD/SID/nSHD together with appendix metrics including precision, recall, AUROC, and AP. The full paper snapshot uses all 1,200 generated SCMs; the public and held-out views split the generated SCM arena into the 600 released SCMs and the reserved 600 SCMs for audited submissions.
Observation-only pairwise win profile
Pairwise win-rate summary over observation-only SCMs and real datasets. Each method pair is compared on both F1 and SHD after averaging repeats; higher F1 or lower SHD is a win, and ties count as 0.5.
Overall benchmark results
Slice-level behavior
The same method can move substantially across benchmark family and data regime. This heatmap uses the same metric family as the aggregate leaderboard, but keeps Synthetic, Semantic, Formula, and Real-data slices separate.
Per-SCM Semantic/Formula analyzer
Select any released Semantic or Formula SCM and inspect how all methods behave on that particular graph. The table reports replicate-averaged metrics for the selected graph; ΔF1 is method-centered, so positive values mean the method performs better on this SCM than on its own average over released Semantic/Formula SCMs in the same regime.
Real-data check
Sources: six CD-CSG observation-only datasets, Sachs flow-cytometry, four PetShop telemetry scenarios, and two Causal Chamber physical-system benchmarks. Obs-only additionally includes observation-only conversions of the seven interventional tables.
Sample-size sensitivity
Synthetic SCMs are fixed at d=30 while observation-only sample size varies. All methods are shown by default; toggle buttons can hide or restore individual curves.
Intervention-protocol sensitivity
The synthetic SCM pool is fixed at d=30; only the intervention design changes. F1 SD summarizes protocol stability.
Runtime and cost
For pretrained/amortized wrappers, the table uses fitted per-graph cost after the one-time model load. For other wrappers, it uses end-to-end per-graph runtime on the synthetic main benchmark.
Submit results or contribute SCMs
Use the same template package for both workflows: method-result submissions live under submission_template/submissions/, while new SCM proposals live under submission_template/scm_contributions/.
Evaluate a new method or upload results
1. Access SCMs
- Download the public dataset repository: LAMDA-Tabular/CausalArena.
- Use the released 500 synthetic, 50 semantic, and 50 formula SCMs for the public board.
2. Prepare result package
- manifest.json: method name, method family, version, implementation URL, checkpoint URL or “N/A”, license, contact, supported regimes, hardware, evaluation date, and training-disclosure notes for possible CausalArena/pretraining overlap.
- predictions/: one score matrix and one binary adjacency matrix for each SCM / regime / repeat, with node order and runtime.
- summary.csv: graph key, benchmark family, regime, repeat, F1, precision, recall, SHD, nSHD, SID when available, AUROC/AP when applicable, runtime, and status.
- Run
python tools/validate_submission.py submissions/<method>before sending. The same validator also checks SCM drafts with--scm.
3. Submit through HuggingFace
- Open a HuggingFace Dataset pull request or Discussion with the result package, or send a download link if the package is large.
- CLI users can submit a draft with
hf upload LAMDA-Tabular/CausalArena submissions/<method> submissions/<method> --repo-type dataset --create-pr. - For a maintained evaluation run, provide a runnable wrapper, environment file, checkpoint access instructions, and expected command line.
- After validation, maintainers update the public / held-out / full-snapshot leaderboard views and archive the accepted package hash.
Contribute new SCMs
SCM contributions can be lightweight or complete. A minimal graph-only proposal may include just graph.json; richer semantic, formula, or executable benchmark entries can add metadata, mechanisms, interventions, and validation logs.
1. Minimal graph
At minimum, provide graph.json with node order and directed edges. This is enough for proposing a new graph structure or benchmark seed.
2. Optional metadata
Add scm_card.json when available: domain, scenario title, variable descriptions, edge rationales, source notes, ranges, intervention handles, and the intended benchmark role or gap filled.
3. Executable benchmark entry
Add generator_spec.json and validation_report.json when the SCM should be executable under the shared obs-only and mixed-interventional protocols.
Method metadata
Parameter counts are meaningful for fixed pretrained checkpoints. Classical and per-dataset optimization methods do not have a single benchmark-wide parameter count.