Skip to main content

adasamp-pareto: adaptive bayes-sampling for multi-criteria optimization

GitHub Actions Documentation Status MIT License

Adaptive optimization algorithm for black-box multi-objective optimization problems with binary constraints on the foundation of Bayes optimization. The algorithm aims to find the Pareto-optimal solution of

\begin{equation*} max [ y(x) ] s.t. f(x) = feasible \end{equation*}

in an iterative procedure. Here, \(y(x)\) denotes the multi-dimensional goals and \(f(x)\) the binary feasibility of the problem (in the sense that certain design variables \(x\) lead to invalid goals). All technical details can be found in the paper “Adaptive Sampling of Pareto Frontiers with Binary Constraints Using Regression and Classification” (https://arxiv.org/abs/2008.12005).

Installation

Install via pip or clone this repository. In order to use pip, type:

$ pip install adasamp-pareto

Usage

The class AdaptiveSampler is used to define and solve a problem instance. Simple example:

from adasamp import AdaptiveSampler

# Create instance
sampler = AdaptiveSampler(func,       # Problem definition: function returns (goals Y, feasibility f)
                          X_limits,   # Design variable limits to search solution in
                          Y_ref,      # Reference point, has to be dominated by any goal Y
                          iterations, # Number of solver iterations
                          Y_model,    # Regression model to predict goals Y
                          f_model)    # Classification model to predict feasibility f

# Return the sampling suggestions X, the corresponding goals Y, and the corresponding feasibilities f.
X, Y, f = sampler.sample()

Demo notebooks can be found in the examples/ directory.

Documentation

Complete documentation is available: https://adasamp-pareto.readthedocs.io/en/latest.

📖 Citation

If you find this code useful in your research, please consider citing:

@misc{heesebortzCITE2020,
              title={Adaptive Sampling of Pareto Frontiers with Binary Constraints Using Regression and Classification},
              author={Raoul Heese and Michael Bortz},
              year={2020},
              eprint={2008.12005},
              archivePrefix={arXiv},
              primaryClass={stat.ML}
     }

Metadata

Release files for adasamp-pareto 1.1

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

Source distribution (sdist)

Source distribution for adasamp-pareto 1.1
File Size Uploaded Provenance
adasamp-pareto-1.1.tar.gz 19.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for adasamp-pareto 1.1
File Interpreter ABI Platform
adasamp_pareto-1.1-py3-none-any.whl Python 3 none any Details

Total release size: 39.2 kB

Release files / adasamp-pareto-1.1.tar.gz

Download URL adasamp-pareto-1.1.tar.gz
Size 19.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4e3e62b6b5cc3be2de358c7ba684575dfe0a7dd260a339cea93794b45d909850
BLAKE2b-256 checksum
How to use checksums
6db40ba052e21ed44ed8b469ce3a4fa0053adcf0912ee9bb50ffcd4d048a4e5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.7

Release files / adasamp_pareto-1.1-py3-none-any.whl

Download URL adasamp_pareto-1.1-py3-none-any.whl
Size 19.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
59062617df65e6e2d4c3b42ff09674ac2a4c1a83cd86c515d796bf595fec53f4
BLAKE2b-256 checksum
How to use checksums
d9ad991dd29de640a7dd1fb11e242d9be157dfddb670b5d41615ee19bc475087
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.7

Security for adasamp-pareto 1.1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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

1.1 This release

2 release files No 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