BayesianEstimationTool (BET)

BayesianEstimationTool fits population-level parameters and individual-specific latent variables with NumPyro inference methods.

Documentation

Start here:

• Manual (Markdown) — model contracts, likelihoods, masking, JAX modeling, inference, persistence, and testing.
• Manual (PDF) — printable manual. If GitHub cannot preview the PDF, download it to view locally.
• Cheatsheet (Markdown) — compact API reference and common workflows.
• Cheatsheet (PDF) — one-page printable reference. If GitHub cannot preview the PDF, download it to view locally.

Manual.md is the authoritative manual. Its PDF is rendered directly from that file using GitHub-like styling and print pagination. The cheatsheet is a separate compact, Python-generated reference. To regenerate locally, install requests, playwright, and reportlab, install Playwright Chromium (python -m playwright install chromium), and set GITHUB_TOKEN to a token permitted to call GitHub's Markdown API for this repository. The manual generator uses GitHub's Markdown rendering API and Playwright; the cheatsheet generator uses ReportLab:

python docs/generators/markdown_to_pdf.py docs/Manual.md
python docs/generators/cheatsheet.py

The GitHub Actions test workflow regenerates the PDFs (and the Python-authored cheatsheet Markdown), checks that the cheatsheet is exactly one PDF page, uploads the outputs as a bet-docs artifact, and runs the test suite.

Installation

BET requires Python 3.10 or newer. Install the latest version from PyPI:

python -m pip install BayesianEstimationTool

To install the specific first release:

python -m pip install BayesianEstimationTool==1.0.1

Alternatively, install directly from the tagged GitHub source:

python -m pip install "git+https://github.com/rafaelrbravo/BayesianEstimationTool.git@v1.0.1"

You can also download a wheel (.whl) or source archive (.tar.gz) from GitHub Releases and install it with python -m pip install PATH_TO_DOWNLOADED_FILE. These release assets become available after publishing.

Verify installation:

python -c "import BayesianEstimationTool as bet; print(bet.Estimator)"

For editable development from a source checkout, run python -m pip install -e . in the repository root. The conda recipe in conda-recipe/meta.yaml is for local builds; BET is not yet published on conda-forge.

See the manual for the minimal model and training examples.

How to cite

If you use BET in your research, please cite:

Bravo, R., Tercan, B., Lima, E., Aguilar, B., & Yankeelov, T. (2026). BayesianEstimationTool (Version 1.0.1) [Computer software]. https://github.com/rafaelrbravo/BayesianEstimationTool

GitHub also provides a Cite this repository option using CITATION.cff.