Reproduce
Use the coefficients
Only Mathematica or Python is needed.
pp = Get["Coefficients/ProtonProton.wl"];
pp["Classes"][13]["LL"] /. {Nc -> 3, Nf -> 5, LR -> 0, LF -> 0, LFF -> 0, v -> 3/10, w -> 1/5} // N
pip install mpmath # the only requirement python3 Coefficients/evaluate.py --check # built-in 50-digit checks python3 Coefficients/evaluate.py pp 13 LL 0.3 0.2 --digits 30
Run the calculation
With an agent (recommended)
An AI coding agent installs and checks the tools for you; you do not need to set them up one by one.
- Install Mathematica and clone the repository.
- Start the agent in the repository folder, with permission to run Mathematica and the external tools without
approving each command: Codex with
codex --approve-for-me(or “Approve for me” under/permissionsat the start of a session); Claude Code in auto mode (Shift+Tab, orclaude --permission-mode auto). The tools write to their user and temporary directories, which a restrictive sandbox blocks. - Paste the setup prompt below. The agent installs FeynCalc, FeynArts, FORM, Tracer, Kira, Fermat and SubTropica and runs the toolchain check until it reports READY.
Set up FeynFacet on this machine. Install the tools it needs, following docs/INSTALL.md (docs/INSTALL-macOS.md on a Mac; on Apple silicon, build Kira with tools/install_kira.py as described there), and run python3 feynfacet.py check --all-routes until it reports READY. Ask me before anything that needs an administrator password.
The installation notes are what the agent follows. Mathematica and its license stay with you, and the agent asks before anything that needs your administrator password; on a Mac this includes Homebrew and Apple's Command Line Tools for Xcode. On Apple silicon the agent builds a patched Kira, since the Kira 3.1 release build can silently return wrong reductions there (details); this one-time build takes a few minutes.
When the check reports READY, open Start.nb and evaluate it, or ask the agent to run a process.
Manually
Install Mathematica with FeynCalc and FeynArts, FORM, Tracer, Kira (with Fermat) and SubTropica (with polymake) (installation notes; on Apple silicon, Kira needs the patched build). Then check the toolchain; the check performs small exact calculations with each tool, including eight Kira reductions, and reports what to fix:
python3 feynfacet.py check # add --all-routes for FORM and Tracer
When it reports READY, open Start.nb and evaluate it: it loads the package and runs the lepton–quark
process end to end. Every process can also be run from a terminal:
python3 Checks/run_process.py Processes/LeptonQuark python3 Checks/run_process.py Processes/PartonicBorn # Born table, read by the proton–proton processes python3 Checks/run_process.py Processes/Hadronic --set class=13 # FeynCalc route first python3 Checks/run_process.py Processes/Hadronic --set class=13 --route FORM # compared with the FeynCalc squares
Each step runs in a fresh kernel; the results of a step are files that the next one reads. The process READMEs give
the order for each process (the crossing check of the spin transfer, for instance, needs the double-transverse classes).
The headless runner records evaluated cells and SHA-256 hashes of calculation sources and recorded inputs and outputs in
Processes/<process>/Results/<step>[-<choices>].receipt.json. A receipt is marked complete after the last cell succeeds.