A living catalogue 📚 of computational methods that attempt to identify mechanistic cause‑and‑effect links and predict responses in unobserved settings. The project curates > 100 peer‑reviewed and pre‑print tools, classifies them by task, and provides a browsable web interface with informative tables and technical descriptions.
| 🎯 Resource | 🌐 URL |
|---|---|
| 📖 Documentation | https://interp-extrap-perturb.readthedocs.io/ |
| 🤝 Contribute | Contribution Guidelines - Add your method! |
We welcome contributions! 🎉 Whether you want to:
- 🆕 Add a new method — Create a YAML file in
methods/ - ✏️ Update existing methods — Edit the corresponding YAML file
- 🐛 Report issues — Open an issue on GitHub
- 💡 Suggest improvements — We're always open to ideas!
👉 Get Started: Check our 📋 Contribution Guidelines for detailed instructions.
methods.yaml ─▶ generate_methods.py ─▶ docs/methods*.rst ─▶ Sphinx ▶ Read the Docs
-
methods.yaml— canonical metadata (method, year, tasks, code link, …). -
generate_methods.pyconverts YAML → ReStructuredText via Jinja2:- One overview page (
methods.rst). - One page per task (slugified).
Tasks are listed in
tasklist.txt; unknown tasks raise a warning.
- One overview page (
-
Sphinx + sphinx‑book‑theme renders the site; ReadTheDocs rebuilds on each push.
graph LR
A[🗃️ methods/*.yaml] --> B[🐍 generate_methods.py]
B --> C[📄 docs/methods*.rst]
C --> D[🔧 Sphinx]
D --> E[🌐 Read the Docs]
style A fill:#e1f5fe
style B fill:#f3e5f5
style C fill:#fff3e0
style D fill:#e8f5e8
style E fill:#fce4ec
- 📁 Individual YAML Files — Each method stored as
methods/method_name.yamlwith structured metadata - 🛠️ Generation Script —
generate_methods.pyconverts YAML → ReStructuredText via Jinja2:- 📊 One overview page (
methods.rst) with sortable table - 🏷️ One page per task category (auto-slugified)
⚠️ Tasks validation againsttasklist.txt
- 📊 One overview page (
- 📚 Sphinx Rendering — Uses sphinx‑book‑theme for professional styling
- 🚀 Auto-Deployment — ReadTheDocs rebuilds on each push to
main
If you use this catalog in your research, please cite our perspective paper (under review).
License: MIT © 2025 Daniel Dimitrov, Stefan Schrod, Martin Rohbeck & Oliver Stegle
MIT © 2025 Daniel Dimitrov, Stefan Schrod, Martin Rohbeck, Oliver Stegle