holm-xie / smt

Surrogate Modeling Toolbox

Surrogate Modeling Toolbox

The surrogate modeling toolbox (SMT) is a Python package that contains a collection of surrogate modeling methods, sampling techniques, and benchmarking functions. This package provides a library of surrogate models that is simple to use and facilitates the implementation of additional methods. SMT is different from existing surrogate modeling libraries because of its emphasis on derivatives, including training derivatives used for gradient-enhanced modeling, prediction derivatives, and derivatives with respect to the training data. It also includes new surrogate models that are not available elsewhere: kriging by partial-least squares reduction and energy-minimizing spline interpolation. SMT is documented using custom tools for embedding automatically-tested code and dynamically-generated plots to produce high-quality user guides with minimal effort from contributors. SMT is distributed under the New BSD license.

To cite SMT: M. A. Bouhlel and J. T. Hwang and N. Bartoli and R. Lafage and J. Morlier and J. R. R. A. Martins. A Python surrogate modeling framework with derivatives. Advances in Engineering Software, 2019.

@article{SMT2019,
	Author = {Mohamed Amine Bouhlel and John T. Hwang and Nathalie Bartoli and Rémi Lafage and Joseph Morlier and Joaquim R. R. A. Martins},
	Journal = {Advances in Engineering Software},
	Title = {A Python surrogate modeling framework with derivatives},
	pages = {102662},
	year = {2019},
	issn = {0965-9978},
	doi = {https://doi.org/10.1016/j.advengsoft.2019.03.005},
	Year = {2019}}

Required packages

SMT depends on the following modules: numpy, scipy, scikit-learn, pyDOE2 and Cython.

Installation

Clone the repository from github then run:

pip install -e <smt_folder>

Tests

To run tests, first install the python testing framework using:

pip install testflo

and run

testflo

Usage

For examples demonstrating how to use SMT, you can take a look at the tutorial notebook or go to the 'smt/examples' folder.

Documentation

http://smt.readthedocs.io

Contact

This repository was created by Mohamed Amine Bouhlel and is maintained by the MDOlab and Onera, the French Aerospace Lab.

Email: [email protected]