Skip to main content

LINX

License: MIT arXiv Run Tests

Light Isotope Nucleosynthesis with JAX (LINX) is a fast, differentiable, extensible code that can be used to predict primordial light element abundances during Big Bang Nucleosynthesis (BBN). LINX is written in python using JAX, and is readable, accessible, and well-documented. Full documentation is available at https://linx.readthedocs.io/en/latest/.

Contents

Installation

It is strongly recommended that you create a clean conda environment with the latest python. All of the requirements are included in requirements.txt. In summary, run

conda create --name linx
conda activate linx
pip install -r requirements.txt

(Include path/to/requirements.txt if you're in a different directory.) This will install the minimum set of dependencies, with the latest versions of your packages available with your selected python version.

If you are running with python <= 3.10, or if you are willing to tolerate old JAX versions for 2x faster runtimes, instead run

conda create --name linx
conda activate linx
pip install -r requirements-fast.txt
python -m pip install --no-deps interpax==0.3.1

Finally, requirements-other.txt provides all auxiliary packages needed to run all notebooks and analyses in this repo.

Repository structure

Modules of the code are contained in the linx directory, along with the various sets of BBN reaction rates that ship with LINX. example_notebooks contains a set of pedagogical Jupyter noteboooks for users familiarizing themselves with LINX. scripts contains a suite of scripts for testing and using LINX. Finally, pytest contains brief pytest scripts for continuous checking of this repository.

Issues

Please feel free to open up an issue if you notice something is amiss in LINX.

Citation

If you use LINX, we suggest you cite both LINX and the other public codes that provide a foundation for LINX: nudec_BSM (https://arxiv.org/abs/1812.05605, https://arxiv.org/pdf/2001.04466), PRIMAT (http://www2.iap.fr/users/pitrou/primat.htm), and PRyMordial (https://arxiv.org/abs/2307.07061).

The suggested language for citation is "LINX [linx], which uses methods and tables from Refs. [nudecBSM1,nudecBSM2,PRIMAT,PRyM]". All of these citations are included below.

@article{linx,
  title={{LINX}: A Fast, Differentiable, and Extensible Big Bang Nucleosynthesis Package}, 
  author = {Giovanetti, Cara and Lisanti, Mariangela and Liu, Hongwan and Mishra-Sharma, Siddharth and Ruderman, Joshua T.},
  journal = {Phys. Rev. D},
  volume = {112},
  issue = {6},
  pages = {063531},
  numpages = {33},
  year = {2025},
  month = {Sep},
  publisher = {American Physical Society},
  doi = {10.1103/f3tj-r882},
  url = {https://link.aps.org/doi/10.1103/f3tj-r882}
}

@article{nudecBSM1,
   title={Neutrino decoupling beyond the {S}tandard {M}odel: {CMB} constraints on the Dark Matter mass with a fast and precise {N}eff evaluation},
   volume={2019},
   ISSN={1475-7516},
   url={http://dx.doi.org/10.1088/1475-7516/2019/02/007},
   DOI={10.1088/1475-7516/2019/02/007},
   number={02},
   journal={Journal of Cosmology and Astroparticle Physics},
   publisher={IOP Publishing},
   author={Escudero, Miguel},
   year={2019},
   month=feb, pages={007–007} }

@article{nudecBSM2,
   title={Precision early universe thermodynamics made simple:{N}eff and neutrino decoupling in the {S}tandard {M}odel and beyond},
   volume={2020},
   ISSN={1475-7516},
   url={http://dx.doi.org/10.1088/1475-7516/2020/05/048},
   DOI={10.1088/1475-7516/2020/05/048},
   number={05},
   journal={Journal of Cosmology and Astroparticle Physics},
   publisher={IOP Publishing},
   author={Abenza, Miguel Escudero},
   year={2020},
   month=may, pages={048–048} }

@article{PRIMAT,
   title={Precision big bang nucleosynthesis with improved {H}elium-4 predictions},
   volume={754},
   ISSN={0370-1573},
   url={http://dx.doi.org/10.1016/j.physrep.2018.04.005},
   DOI={10.1016/j.physrep.2018.04.005},
   journal={Physics Reports},
   publisher={Elsevier BV},
   author={Pitrou, Cyril and Coc, Alain and Uzan, Jean-Philippe and Vangioni, Elisabeth},
   year={2018},
   month=sep, pages={1–66} }

@article{PRyM,
    author = "Burns, Anne-Katherine and Tait, Tim M. P. and Valli, Mauro",
    title = "{PRyMordial: the first three minutes, within and beyond the Standard Model}",
    eprint = "2307.07061",
    archivePrefix = "arXiv",
    primaryClass = "hep-ph",
    reportNumber = "UCI-HEP-TR-2023-07, YITP-SB-2023-16",
    doi = "10.1140/epjc/s10052-024-12442-0",
    journal = "Eur. Phys. J. C",
    volume = "84",
    number = "1", pages = "86",
    year = "2024" }

References

A detailed reference outlining the structure and philosophy of LINX and including examples of how to use it with gradient-assisted methods is available at https://arxiv.org/abs/2408.14538.

An example of an analysis that can be performed with LINX, where LINX is used with CLASS to perform an analysis with a joint CMB and BBN likelihood, is available at https://arxiv.org/abs/2408.14531.

Metadata

Release files for linx-bbn 0.1.4

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

Source distribution (sdist)

Source distribution for linx-bbn 0.1.4
File Size Uploaded Provenance Actions
linx_bbn-0.1.4.tar.gz 906.8 kB With provenance Details for linx_bbn-0.1.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for linx-bbn 0.1.4
File Interpreter ABI Platform Actions
linx_bbn-0.1.4-py3-none-any.whl Python 3 none any Details for linx_bbn-0.1.4-py3-none-any.whl

Total release size: 1.9 MB

Release files / linx_bbn-0.1.4.tar.gz

Download URL linx_bbn-0.1.4.tar.gz
Size 906.8 kB
Tags Source
SHA-256 checksum
How to use checksums
480397ca7c8e2c68ec21a3b8eb75cbdb2212cfbb8a348fcf174fea8365e9d077
BLAKE2b-256 checksum
How to use checksums
9df265670ce38357b53ccb05da5d6090bcdd3acb317457e151727db489bfdf54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 26, 2026.

Transparency log

Release files / linx_bbn-0.1.4-py3-none-any.whl

Download URL linx_bbn-0.1.4-py3-none-any.whl
Size 953.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a722b734c4122d0ba4f1513456eea19b76773571d8118db79d3f773fb378b844
BLAKE2b-256 checksum
How to use checksums
2620bcc9526685eecb8e101aefa0721260e7aee827c5b2684ea3092b31c90ba8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 26, 2026.

Transparency log

Security for linx-bbn 0.1.4

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 linx_bbn-0.1.4.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 26, 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.

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files Full provenance

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