General-purpose HEP calculation reproduction/audit runner that orchestrates Mathematica (FeynCalc/FeynArts/FormCalc/LoopTools/FeynRules) and/or Julia (LoopTools.jl). Supports: compute-only runs, LaTeX value auditing, auto-generation of Feynman diagrams + one-loop (unrenormalized) amplitudes (FeynRules→FeynArts→(optional)FormCalc), optional LaTeX-driven model_build scaffolding (agent-provided rewrite rules), and auditable out_dir + optional research-team sync.
Primary entry point:
bash scripts/run_hep_calc.sh --job job.yml --out /absolute/path/outside/repoStart here (compute-first):
out_dir/summary.json + out_dir/manifest.json + out_dir/analysis.jsonout_dir/report/audit_report.mdout_dir/logs/*.log and per-step status.jsonAs an agent, always clarify with the user:
Use hep-calc when the primary need is an auditable computation run, optionally paired with TeX comparison or model_build scaffolding, including any of the following:
Do NOT use this skill for:
| Goal | Job keys to set | Key outputs |
|---|---|---|
| Compute-only (no TeX comparison) | leave latex.targets: [] (or omit targets) | report/*, symbolic/*, numeric/* |
| TeX audit (compare vs paper) | set latex.tex_paths + latex.targets[] (id + label or regex) | tex/extracted.json, tex/comparison.json |
| auto_qft (FeynRules model) | auto_qft.process.in/out + auto_qft.model_files + auto_qft.lagrangian_symbol | auto_qft/diagrams/*, auto_qft/amplitude/* |
| auto_qft (FeynArts-only) | auto_qft.feynarts_model + process.in_fa/out_fa | same (skips FeynRules export) |
| LaTeX→model_build→auto_qft | auto_qft.model_build.* + rewrite_wls + base_model_files | auto_qft/model_build/* + auto_qft/* |
| Custom FA/FC pipeline (scaffold) | enable_fa_fc: true + feynarts_formcalc_spec.entry | feynarts_formcalc/status.json |
Prefer starting from the demo jobs in assets/ and editing them. These snippets are minimal, correct templates.
Start from assets/demo_auto_qft_qed_bhabha.yml.
schema_version: 1