BITS for GAPS

CI PyPI Docs

Bayesian Information-Theoretic Sampling for hierarchical GAussian Process Surrogates.

A framework for information-theoretic sequential experimental design with Bayesian hierarchical Gaussian-process surrogates. Prior physical knowledge is encoded through priors on the GP hyperparameters; sampling is guided by maximizing the predictive differential entropy, so hyperparameter uncertainty (not just predictive variance) drives data acquisition.

Reference: K. D. Jones and A. W. Dowling, "BITS for GAPS: Bayesian Information-Theoretic Sampling for hierarchical GAussian Process Surrogates," Computers & Chemical Engineering 211 (2026) 109650. https://doi.org/10.1016/j.compchemeng.2026.109650

Status: pre-1.0, under active refactor. This repository is being extracted from the paper's research code into a reusable library. See REFACTOR_PLAN.md for the roadmap and HANDOFF.md for the current state.

Install (development)

conda env create -f environment.yml
conda activate bits_for_gaps
pip install -e ".[dev]"          # core + test tools
# pip install -e ".[dev,vle]"    # add the Julia/Clapeyron VLE example backend

The core library is pure Python (GPflow / TensorFlow / NumPy / SciPy) with no Julia dependency. Julia + Clapeyron are only needed for the vle_distillation example.

macOS note: set export PYTHON_JULIACALL_HANDLE_SIGNALS=yes before importing juliacall, or Julia crashes with a bus error (SIGBUS).

Layout

src/bits_for_gaps/   the library (algorithm)
examples/            worked examples (incl. the paper's VLE/distillation case study)
paper/               scripts + reference metrics to reproduce the published figures
tests/               unit / integration / regression tests
docs/                Sphinx documentation (ReadTheDocs)

Quick test

pytest -q

Docs

pip install -e ".[docs]"
sphinx-build -W docs docs/_build/html

Full docs (installation, a pure-Python quickstart, theory notes, the VLE example, and the API reference): docs/index.md, or built and browsed locally as above. See HANDOFF.md for ReadTheDocs setup status.

Project links

Data verified by PyPI on Aug 6, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for adowling2 from gravatar.com adowling2

Credits

Author: Kyla D. Jones

GitHub Statistics

Data verified by PyPI on Aug 6, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

BSD License (BSD 3-Clause License)

Requires

Python <3.10, >=3.9

Provides Extra

dev docs vle

Tags

bayesian-optimization experimental-design gaussian-process hybrid-modeling information-theory surrogate-modeling

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bits_for_gaps-0.1.1.tar.gz (34.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bits_for_gaps-0.1.1-py3-none-any.whl (37.4 kB view details)

Uploaded Python 3

File details

Details for the file bits_for_gaps-0.1.1.tar.gz.

File metadata

  • Download URL: bits_for_gaps-0.1.1.tar.gz
  • Upload date:
  • Size: 34.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bits_for_gaps-0.1.1.tar.gz
Algorithm Hash digest
SHA256 1b0c41e042187a46cd57a84da9c03af1b29cec77b43abf508d0ca46945d3dc6a
MD5 b26643e50ee6a4a2e1cea9d269756ca0
BLAKE2b-256 04f7e636a4baf10312c335b57e865b75d7bfb11763fccebf6c4a60d757b36b22

See more details on using hashes here.

Provenance

The following attestation bundles were made for bits_for_gaps-0.1.1.tar.gz:

Publisher: publish.yml on dowlinglab/bits_for_gaps

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bits_for_gaps-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: bits_for_gaps-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 37.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bits_for_gaps-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f514a72ffe6333a0c4eb82c385bbca0d075a59c70413ff8b77d0f8218cbb16a2
MD5 a5ca2434c2c22f45afb13d2076545667
BLAKE2b-256 79505b508527cf635fa54c47cc41f753b305fb5a169dbd14f683081a2e60aa0d

See more details on using hashes here.

Provenance

The following attestation bundles were made for bits_for_gaps-0.1.1-py3-none-any.whl:

Publisher: publish.yml on dowlinglab/bits_for_gaps

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page