Skip to main content

rundex

JAX port of RunDec v3.1 — running and decoupling of the strong coupling αs and quark masses in QCD.

Original Mathematica package by K.G. Chetyrkin, J.H. Kühn, M. Steinhauser, and F. Herren.
References: hep-ph/0004189, arXiv:1703.03751.

Installation

pip install rundex

Requires Python ≥ 3.10, JAX ≥ 0.4, and diffrax.

Quick start

import jax

jax.config.update("jax_enable_x64", True)  # required for physics-level precision

from rundex import AlphasExact, AlphasLam, LamExpl, LamImpl

# Λ_MS^(5) from αs(MZ)
lam = LamExpl(0.118, 91.18, nf=5, loops=5)  # → 0.2086 GeV

# αs(μ) from Λ (analytic expansion)
als = AlphasLam(lam, mu=1000.0, nf=5, loops=5)

# αs(μ) by numerically integrating the RGE
als = AlphasExact(0.118, mu0=91.18, mu=1000.0, nf=5, loops=5)

# Optional: compile once for fixed (nf, loops) to avoid retracing
from rundex import compiled_AlphasExact

alphas_exact_5l_nf5 = compiled_AlphasExact(nf=5, loops=5)
als_fast = alphas_exact_5l_nf5(0.118, 91.18, 1000.0)

Note on 64-bit precision
JAX defaults to 32-bit floats. Always call jax.config.update("jax_enable_x64", True) before importing or calling any rundex function. The package itself does not set this flag so it does not interfere with the rest of your JAX code.

Development

git clone ...
pip install -e ".[dev]"
pytest

Numerical tests are cross-validated against rundec-python (CRunDec C++ wrapper), which is a test-only dependency not required by rundex itself.

Implemented RunDec functions (subset)

The following RunDec functions are currently ported to rundex:

  • LamExpl
  • LamImpl
  • AlphasLam
  • AlphasExact
  • AlL2AlH
  • AlH2AlL
  • mMS2mMS
  • mMS2mOS
  • mMS2m1S
  • mOS2mMS
  • mOS2mSI
  • DecMqUpOS
  • DecMqDownOS
  • mL2mH
  • mH2mL

Not all RunDec functionality is ported yet.

Compiled helpers (available for all ported functions)

Each ported function above has a compiled helper named compiled_<FunctionName>. Use these when you call the same function many times with fixed discrete settings (for example fixed nf, loops, and fixed threshold/light-quark data).

Examples:

  • compiled_LamExpl(nf, loops)
  • compiled_LamImpl(nf, loops)
  • compiled_AlphasLam(nf, loops)
  • compiled_AlphasExact(nf, loops)
  • compiled_AlL2AlH(decpar, loops)
  • compiled_AlH2AlL(decpar, loops)
  • compiled_mMS2mMS(nf, loops)
  • compiled_mMS2mOS(nf, loops, mq=None, fdelm=1.0)
  • compiled_mMS2m1S(nl, loops, mq=None, fdelm=1.0)
  • compiled_mOS2mMS(nf, loops, mq=None, fdelm=1.0)
  • compiled_mOS2mSI(nf, loops, mq=None, fdelm=1.0)
  • compiled_DecMqUpOS(nf, loops)
  • compiled_DecMqDownOS(nf, loops)
  • compiled_mL2mH(decpar, loops)
  • compiled_mH2mL(decpar, loops)

When to use which:

  • Use regular functions for one-off calls or frequently changing setup parameters.
  • Use compiled helpers for repeated calls with fixed setup parameters.

Metadata

Release files for rundex 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rundex 0.2.0
File Size Uploaded Provenance Actions
rundex-0.2.0.tar.gz 36.8 kB With provenance Details for rundex-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rundex 0.2.0
File Interpreter ABI Platform Actions
rundex-0.2.0-py3-none-any.whl Python 3 none any Details for rundex-0.2.0-py3-none-any.whl

Total release size: 60.2 kB

Release files / rundex-0.2.0.tar.gz

Download URL rundex-0.2.0.tar.gz
Size 36.8 kB
Tags Source
SHA-256 checksum
How to use checksums
0f965191cf6d22e43e4ab2505ca64f36bfe7f720a3b8fe496ddffdfa146e6763
BLAKE2b-256 checksum
How to use checksums
9dad95ca2445a40679ea8fcb8ddf5a0bb05a53d20dc1c5d7568791be0925a247
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release files / rundex-0.2.0-py3-none-any.whl

Download URL rundex-0.2.0-py3-none-any.whl
Size 23.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a633dc1459e6805213dbe258907afe008a973e25c8242925fde2d5ae5787d622
BLAKE2b-256 checksum
How to use checksums
8d81fe7e67d21a4a59a62e5559e8d20cb1bc9ddafbae6b5c9e1dd72623ba5989
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Security for rundex 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for rundex-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page