LaMET-Agent: An Agent Framework for Large-Momentum Effective Theory Analysis
Organizations: Fermi National Accelerator Laboratory, Batavia, IL 60510, USA · Maryland Center for Fundamental Physics, University of Maryland, College Park, MD 20742, USA · Physics Division, Argonne National Laboratory, Lemont, IL 60439, USA · Department of Physics, Indiana University, Bloomington, IN 47405, USA · Physics Department, Brookhaven National Laboratory, Upton, New York 11973, USA · School of Science and Engineering, The Chinese University of Hong Kong, Shenzhen 518172, China
Abstract
Large-momentum effective theory (LaMET) provides a first-principles framework for computing the dependence of light-cone parton distributions from lattice QCD. Over the past decade, theoretical and numerical advances have established a mature multi-stage workflow for systematic calculation of parton physics, although its implementation still requires expert judgment and substantial repeated effort. We present lamet-agent, an open-source large language model (LLM) agent framework that organizes this workflow into an executable, reproducible, and inspectable analysis pipeline. The present release supports collinear quark distributions and implements correlator analysis, renormalization, Fourier transformation, perturbative matching, continuum, physical pion mass and infinite-momentum extrapolations, and automated result review. We validate it on four end-to-end analyses: pion parton distribution functions in the gauge-invariant and Coulomb-gauge formulations, and pion and kaon distribution amplitudes, obtaining results consistent with the published calculations. Extensions to transverse-momentum-dependent distributions, generalized transverse-momentum-dependent distributions, and gluonic distribution functions are planned for subsequent releases.
Figures & tables
| Coulomb gauge | Gauge invariant | |
| Momenta | / , | / , |
| Correlator fit | joint 2pt 3pt ratio, 2 states | joint 2pt 3pt ratio, 2 states |
| fit window | rest : ; ; boosted : ; ; | rest: ; ; boosted: ; ; |
| / | / | |
| Renormalization | hybrid scheme with an external rest-frame denominator; | hybrid scheme with an external rest-frame denominator; |
| , | , | , |
| Pion DA | Kaon DA | |
| Momenta | ; = , , and | same momenta and ensembles |
| Correlator fit | one-state fits to the real and imaginary parts of the nonlocal-to-local qDA ratio | simultaneous fit to the nonlocal qDA correlator and its aligned two-point correlator |
| fit window | ||
| Renormalization | ratio scheme with self-renormalization; the common zero-momentum pion reference determines ; | same reference and strategy applied to the kaon matrix elements |
| Asymptotic region |
Appendix figures & tables9 assets
Supplementary material from the paper’s appendix.
Appendix
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| run_id | string | Human-readable identifier for one analysis run and its artifacts. |
| root_directory | path string | Filesystem base used to resolve relative input paths. |
| artifacts_directory | path string | Directory receiving per-job outputs and diagnostics. |
| random_seed | nonnegative integer | Common seed for reproducible resampling and stochastic numerical procedures. |
| workers | positive integer | Run-wide limit on concurrent sample-wise calculations. |
| target_observable | pdf , da , or gpd | Physical distribution produced by the workflow; it activates observable-specific stage fields. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| stages | nonempty ordered object | Ordered stage mapping defining the sequence of physical transformations. |
| stages.<stage>.defaults | object; optional | Authored common values inherited by jobs in that stage. |
| stages.<stage>.jobs | nonempty ordered list | Physical jobs retain authored order before systematic expansion. |
| jobs[].id | safe identifier string | Stable graph identifier used for dependencies and job artifacts. |
| jobs[].inputs | role-to-source object; default {} | Maps each physical input role to an upstream job, external file, or explicitly permitted source form. |
| jobs[].<stage parameter> | stage-specific value | Job-specific physical choice overriding the inherited stage default. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| inputs.correlators | nonempty list of descriptor records | Explicit ordered correlator selection; one descriptor may contain many records. |
| inputs.correlators[].json | string ending in .json | Descriptor containing the selected correlator’s data definition. |
| inputs.correlators[].id | nonempty string | Unique record identifier selecting one correlator from that descriptor. |
| analysis_method | lsqfit or lanczos ; default lsqfit | Uses sample-wise nonlinear least squares or a Lanczos extraction. |
| component | re , im , or both | Selects the real, imaginary, or both matrix-element channels. |
| nstate ( lsqfit ) | object mapping each fit_scope atom to a nonempty list of positive integers | Per-correlator spectral truncations scanned by the fit; keys must be bare atoms, never joint + strings. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| strategy | external_denominator , self_renormalization | Uses a factor determined outside the workflow or extracts a reusable factor from reference matrix elements. |
| normalization | Boolean | If true, divides every sample by its unique value before renormalization. |
| scheme | ratio , hybrid , or msbar | Selects how the supplied or fitted factor enters; hybrid separates short- and long-distance prescriptions. |
| type | apply for external_denominator , fit / apply for self_renormalization | Fits a reusable from references or applies the selected prescription to a target; external factors are apply-only. |
| inputs.target | job id or file source | Bare matrix element to be renormalized. |
| inputs.denominator | job id or file source; a nonzero constant only where permitted | External factor dividing the target; hybrid use requires a coordinate-dependent source and also anchors continuity in self-hybrid application. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| inputs.input | job id or file source | Renormalized coordinate-space matrix element. |
| inputs.hermitian_partner | job id or file source; default none | Exchanged-flow GPD partner with reversed source and sink momenta, supplying the negative- branch by Hermiticity. |
| quasi_y_ls | increasing list or {start,stop,num} | Dimensionless grid. |
| zmin_fm , zmax_fm | nonempty lists of nonnegative and positive numbers | Candidate lower/upper tail-fit boundaries; one common range is selected from sample-average data before resample fits. |
| tail_window_step_offset | integer; default 0 | Shifts every by the signed distance while holding fixed; zero is the unshifted central job. |
| zmax_ext_fm | positive number | Requested maximum in the finite sum. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| inputs.quasi | job id or file source | One quasi-distribution whose attributes supply , the hybrid , and the parton, observable, gauge, operator, scheme, and component provenance fixing the kernel. |
| order | nlo | Only next-to-leading-order matching kernels are currently available. |
| resummation | "" , rgr , or lrr ; default "" | Empty selects fixed order; rgr resums the running coupling and takes its real/imaginary kernel suffix from the upstream source component; lrr resums the leading renormalon. |
| mu | positive number in GeV | light-cone scale entering the coefficient function through . |
| lc_x_ls | increasing list or {start,stop} | Exact output grid, or a closed window selecting existing quasi-grid points without interpolation. |
| kernel_parameters | object; default {} | Overrides checked against the selected kernel signature; every kernel accepts the plus-prescription regulator eps , and RGR kernels add kappa and mu_min_gev , which set and keep above the Landau pole. The grids and cannot be overridden. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| operation | fit or systematics_budget ; default fit | Fits where the selected correction bases vanish, or performs no refit and assembles statistical and systematic errors. |
| inputs.distributions | nonempty ordered list of job ids/file sources | Matched finite-parameter distributions for the scaling fit, or indexed central and variant distributions for the budget. |
| x_independent_terms | unique list; default [] | Bases in with one correction coefficient shared over all . |
| x_dependent_terms | unique list; default [] | Bases with independent , allowing cutoff, momentum, mass, or volume effects to distort the shape; disjoint from the shared list. |
| Supported term identifiers | a , a2 , a4 , ap2 , ap4 , exp_mpi_L , exp_sqrt2_mpi_L , mpi2 , mpi4_log_mpi2 , inv_p2 , inv_p4 | Implement , raw , finite-volume exponentials, physical-point-subtracted pion-mass terms, and higher-twist terms . |
| priors | exactly {mean,sdev} ; default {0,3} | Common numerical Gaussian prior for and all correction coefficients in their native units. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| inputs.results | nonempty ordered list of job ids/file sources | Explicit, ordered prior results defining the evidence available to review. |
| catalog | string | Selects the built-in catalog or a literature catalog resolved relative to the run root. |
| max_papers | positive integer | Bounds the number of selected full-text papers exposed to the reviewer. |
| report_language | en or ch | Generates the review prose directly in English or Chinese. |
| checks | nonempty list drawn from identity , units , kinematics , schemes , grids , resampling , extrapolation | Explicit controlled set of cross-result consistency checks requested from review. |
| JSON field | Accepted value | Physical meaning or condition |
|---|---|---|
| systematics.<stage> | object keyed by fourier_transform , perturbative_matching , or extrapolation | Adds uncertainty variants only to a stage already present in the central workflow. |
| defaults | object; default {} | Common values inherited by variants before explicit overrides; central jobs are unchanged. |
| fourier_transform.variants[].id | safe lowercase identifier | Stable suffix and provenance label for one Fourier-tail variation. |
| fourier_transform.variants[]. tail_window_step_offset | nonzero integer | Moves every by the signed distance , leaving and other Fourier settings fixed. |
| perturbative_matching.variants[].id | safe lowercase identifier | Stable suffix and provenance label for one matching-scale variation. |
| perturbative_matching.variants[]. mu_factor | positive number other than 1 | Multiplies the central , conventionally by or , for the matching-scale uncertainty. |