Skip to main content

SBArchOpt: Surrogate-Based Architecture Optimization

Project description

SBArchOpt Logo

SBArchOpt: Surrogate-Based Architecture Optimization

Tests PyPI License JOSS Documentation Status

GitHub Repository | Documentation

SBArchOpt (es-bee-ARK-opt) provides a set of classes and interfaces for applying Surrogate-Based Optimization (SBO) for system architecture optimization problems:

  • Expensive black-box problems: evaluating one candidate architecture might be computationally expensive
  • Mixed-discrete design variables: categorical architectural decisions mixed with continuous sizing variables
  • Hierarchical design variables: decisions can deactivate/activate (parts of) downstream decisions
  • Multi-objective: stemming from conflicting stakeholder needs
  • Subject to hidden constraints: simulation tools might not converge for all design points

Surrogate-Based Optimization (SBO) aims to accelerate convergence by fitting a surrogate model (e.g. regression, gaussian process, neural net) to the inputs (design variables) and outputs (objectives/constraints) to try to predict where interesting infill points lie. Potentially, SBO needs about one or two orders of magnitude less function evaluations than Multi-Objective Evolutionary Algorithms (MOEA's) like NSGA2. However, dealing with the specific challenges of architecture optimization, especially in a combination of the challenges, is not trivial. This library hopes to support in doing this.

The library provides:

  • A common interface for defining architecture optimization problems based on pymoo
  • Support in using Surrogate-Based Optimization (SBO) algorithms:
    • Implementation of a basic SBO algorithm
    • Connectors to various external SBO libraries
  • Analytical and realistic test problems that exhibit one or more of the architecture optimization challenges

Installation

First, create a conda environment (skip if you already have one):

conda create --name opt python=3.9
conda activate opt

Then install the package:

conda install numpy
pip install sb-arch-opt

Note: there are optional dependencies for the connected optimization frameworks and test problems. Refer to their documentation for dedicated installation instructions.

Documentation

Refer to the documentation for more background on SBArchOpt and how to implement architecture optimization problems.

Citing

If you use SBArchOpt in your work, please cite it:

Bussemaker, J.H., (2023). SBArchOpt: Surrogate-Based Architecture Optimization. Journal of Open Source Software, 8(89), 5564, DOI: 10.21105/joss.05564

Bussemaker, J.H., et al., (2024). Surrogate-Based Optimization of System Architectures Subject to Hidden Constraints. In AIAA AVIATION 2024 FORUM. Las Vegas, NV, USA. DOI: 10.2514/6.2024-4401

Contributing

The project is coordinated by: Jasper Bussemaker (jasper.bussemaker at dlr.de)

If you find a bug or have a feature request, please file an issue using the Github issue tracker. If you require support for using SBArchOpt or want to collaborate, feel free to contact me.

Contributions are appreciated too:

  • Fork the repository
  • Add your contributions to the fork
    • Update/add documentation
    • Add tests and make sure they pass (tests are run using pytest)
  • Read and sign the Contributor License Agreement (CLA) , and send it to the project coordinator
  • Issue a pull request into the dev branch

Adding Documentation

pip install -r requirements-docs.txt
mkdocs serve

Refer to mkdocs and mkdocstrings documentation for more information.

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

sb_arch_opt-1.5.3.tar.gz (154.0 kB view details)

Uploaded Source

Built Distribution

sb_arch_opt-1.5.3-py3-none-any.whl (210.4 kB view details)

Uploaded Python 3

File details

Details for the file sb_arch_opt-1.5.3.tar.gz.

File metadata

  • Download URL: sb_arch_opt-1.5.3.tar.gz
  • Upload date:
  • Size: 154.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for sb_arch_opt-1.5.3.tar.gz
Algorithm Hash digest
SHA256 670a82922d7f1669c3105ad7e0d0e8f0e2ca1e6c16d7200ed14a19cef815a769
MD5 106e8e4e4382c7ad5f39eca03d3bad8e
BLAKE2b-256 26dfbcdd2a8a689f064ae47cff2541a2e5f5417e48ca1c531c90acd4f1e0c089

See more details on using hashes here.

File details

Details for the file sb_arch_opt-1.5.3-py3-none-any.whl.

File metadata

  • Download URL: sb_arch_opt-1.5.3-py3-none-any.whl
  • Upload date:
  • Size: 210.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for sb_arch_opt-1.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9d6a666620e7ab230f716d32212f3b55f54174496461841711d199427d5483b3
MD5 25838754aad03ff5c71dbac190ca79af
BLAKE2b-256 8c20d91ae98f017346bbbb6abdc097a1f32d8428857433e9f4534cabfe1a6b11

See more details on using hashes here.

Supported by

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