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.0.tar.gz (16.4 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.0-py3-none-any.whl (25.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mfbo-0.1.0.tar.gz
Algorithm Hash digest
SHA256 25778ae2afa2ed78c62c6d86978905f13974fbf5286152b21565afbcefd39a6b
MD5 8c9414e9253aa759f27de1e22e1bf510
BLAKE2b-256 fcfdd817b236e95304a6f7bdfbc7611c5e007f27b3e8054b71c87cf1183ad71c

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for mfbo-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 310b31cd147a47c75a670bea3f869ff3eb8762a0572c9b82f8633d4a1ea9428a
MD5 473f455dcd013b550e0b9bdfcc96a3da
BLAKE2b-256 d81205828487237ab19d50d4a9c8498acb450c403c1b0650f82fdc1f4301ab79

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