Skip to main content

Multi-fidelity surrogate models (NN ensembles and co-kriging) compatible with BoTorch.

Project description

mfbo

"mfbo" is a Python library for "multi-fidelity surrogate modeling and Bayesian optimization". It provides neural-network ensemble surrogates and Gaussian-process co-kriging models that are fully compatible with "BoTorch". The library is designed for scientific and engineering optimization problems.

mfbo is a Python library for multi-fidelity surrogate modeling and Bayesian optimization. It provides neural-network ensemble surrogates and Gaussian-process co-kriging models that are fully compatible with BoTorch.

The library is designed for scientific and engineering optimization problems where high-fidelity evaluations are expensive and multiple fidelity levels are available.


Reference

This library implements methods described in:

Passakorn Paladaechanan et al.
Adaptive Gated Multi-Fidelity Neural Networks for Bayesian Optimization
Ocean Engineering, 2025
https://www.sciencedirect.com/science/article/pii/S002980182502997X

If you use this library in academic work, please cite the above paper.


Features

  • Multi-fidelity neural surrogate ensembles
    • MLPEnsemble
    • MFNNEnsemble
    • AGMFNetEnsemble
    • Ada2MFEnsemble
  • Gaussian-process surrogate models
    • Kriging
    • AR(1) Co-Kriging (Kennedy–O’Hagan model)
  • Native BoTorch compatibility
    • All models expose a posterior() method
  • Supports multi-output objectives
  • Designed for Bayesian optimization workflows

Dependencies

mfbo is built on the PyTorch Bayesian optimization ecosystem:

  • PyTorch ≥ 2.5
  • GPyTorch ≥ 1.15
  • BoTorch ≥ 0.16
  • tqdm ≥ 4.67

Please install PyTorch separately according to your system (CPU or CUDA) before installing mfbo.

Installation

1. Install PyTorch

Install PyTorch first (CPU or CUDA version depending on your system):

https://pytorch.org/get-started/locally/

2. Install mfbo

pip (PyPI)

pip install mfbo

conda (conda-forge)

conda install -c conda-forge mfbo

Contact

For questions related to the implementation or the associated research,
please contact:

Passakorn Paladaechanan
Email: p.paladaechanan@gmail.com

Project details


Download files

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

Source Distribution

mfbo-0.1.1.tar.gz (26.6 kB view details)

Uploaded Source

Built Distribution

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

mfbo-0.1.1-py3-none-any.whl (38.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mfbo-0.1.1.tar.gz
  • Upload date:
  • Size: 26.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mfbo-0.1.1.tar.gz
Algorithm Hash digest
SHA256 77b7b8a6f49e8aeba1515c3f5cccb3c2a94b658de9db5c4f07276ae492306d52
MD5 3bdb9608326d48f95b2f10eecc879ddb
BLAKE2b-256 015067688c37e6b87a52b78f89ce0c0c49e1a4b5272fe5e4b057b5f9c7512e04

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mfbo-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 38.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for mfbo-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4da496033afaec80c249d742e45b48cbacfc5cb9ecbe68d08f4cb72202b830ad
MD5 9ad12165b07c2483754699ea76968904
BLAKE2b-256 1d140f9a3cdaa62875755044a46eac898f971413535fbb74e8d68223c1e22c13

See more details on using hashes here.

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