A modular interface for surrogate models and tools
Project description
Introduction to surmise
surmise is a Python package that is designed to provide a surrogate model interface for calibration, uncertainty quantification, and sensitivity analysis.
Dependencies
surmise is build for Python 3.8 or above, with the following dependencies:
numpy>=1.18.3
scipy>=1.7
scikit-learn>=1.2.0
Installation
From the command line, use the following command to install surmise:
pip install surmise
The list of available .whl files can be found under PyPI-wheel. If a wheel file for your preferred platform is not listed, surmise has to be built from source, which requires extra dependencies:
git clone https://github.com/bandframework/surmise/ cd surmise pip install -r requirements.txt
Testing
The test suite requires the pytest and pytest-cov packages to be installed. The packages can be installed via:
pip install pytest pytest-cov
The test suite can then be run from within the tests/ directory of the source distribution by running:
cd tests ./run-tests.sh
Further options are available for testing. To see a complete list of options, run:
./run-tests.sh -h
Coverage reports are produced under tests/cov_html directory only if all tests are used.
Documentation
The documentation is stored in docs/ and is compiled with the Sphinx Python documentation generator. It is written in the reStructuredText format. The documentation is hosted at Read the Docs.
To compile the documentation, first ensure that Sphinx and its dependencies are installed. To install Sphinx and/or ensure compatibility of dependencies, run make from a terminal within the docs/ directory:
cd docs make
To generate documentation, run command make html from a terminal within the docs/ directory:
(cd docs) make html
The HTML files are then stored in docs/_build/html.
Citation:
Please use the following to cite surmise in a publication:
@techreport{surmise2023,
author = {Matthew Plumlee and \"Ozge S\"urer and Stefan M. Wild and Moses Y-H. Chan},
title = {{surmise 0.2.0} Users Manual},
institution = {NAISE},
number = {Version 0.2.0},
year = {2023},
url = {https://surmise.readthedocs.io}
}
Examples
We provide examples in the examples/ directory to illustrate the basic usage of surmise.
In addition, for a gentle introduction of emulation and calibration using Gaussian processes, visit surmise Jupyter notebook.
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
Built Distributions
Hashes for surmise-0.2.1-cp312-cp312-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a1632ba6af853cf23f13a72476a171e58eddaace6cede4da2bfdabdd59b80c67 |
|
MD5 | edf71acac01b143ebb39f030c8a08432 |
|
BLAKE2b-256 | 7c759eade4519800cd12165f2467708ab33e2cd223d3433f994c95ea10f0402c |
Hashes for surmise-0.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d6b69d63d0d593fbc461b3729406687e8c5fedf6ed36c522f3706f1704c1455b |
|
MD5 | ccabd220ff3add37d1ac41750ab303e9 |
|
BLAKE2b-256 | a879249022e3c95955eab70bc15edbae3979f11c1cb957667c80a8b10196f96e |
Hashes for surmise-0.2.1-cp312-cp312-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c8901c72cea8718825340027a26d14f6d18db7627b371f65caa5a59251b18a7e |
|
MD5 | 45da5c0d67b940241124d4d0457275f0 |
|
BLAKE2b-256 | a942efabf44f081444d70eda1cc86e5a7f4bb4aea44a86eece107e19237957a1 |
Hashes for surmise-0.2.1-cp311-cp311-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21e30ebd5af3d9ca812944b13f172fa0dcd0d50c0f1d326b5917260ffe76e9e7 |
|
MD5 | f5f2a914c07a247950dec23502d617df |
|
BLAKE2b-256 | b27606191bd7e485797ca8ffd5d403de24fc41347c929be4743c16d78cd71b2a |
Hashes for surmise-0.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 75d44be8414e493283db27709a68f2983dea2994681ab45196df7cc44963d51d |
|
MD5 | d8e8d1d0a944e10109bc64aa58645ccb |
|
BLAKE2b-256 | 91402ae19cc72e6f335945981f5a7d244265febfd72b6f623aa450e6c3f32861 |
Hashes for surmise-0.2.1-cp311-cp311-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 79dc3768e79dae1b6374e33d290d741655ea20b2554c1c7f904029ec902ac4ab |
|
MD5 | aa41e11c991c5991297c2997526f0a00 |
|
BLAKE2b-256 | 8a82325fbc0c03dbe4eba8d2a03ad95cdb12f6ee4865671b9fd90901adfae2e7 |
Hashes for surmise-0.2.1-cp310-cp310-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 88976b1ce497954db73675eaf7607d0f7a14ebbf648bb0a6a1a3060276c9a9d9 |
|
MD5 | 00f0fded08bd5a0e2094bfb6c332b76e |
|
BLAKE2b-256 | 2c7441018946ba5a1e8de6bfcfb02eb98b55e85a964832ae04f95fe5b45e4ebb |
Hashes for surmise-0.2.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1d0c2fcd460a87369eef7a5a5479d1b9fce089b8ff6c3aea48cee87ccd23492 |
|
MD5 | 6ac8a961b500753c1dc8cd06bdb81377 |
|
BLAKE2b-256 | 98e5e4186198e889d5790617d9eb26db966e6fa8aa80eca40fc1ecaab7b30f2f |
Hashes for surmise-0.2.1-cp310-cp310-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b7f47ac69085adce96a39621698cebce45292d1861d45957dcfeb72892ff9816 |
|
MD5 | 845a0e803988b8d5e9bab11c3801120d |
|
BLAKE2b-256 | eddfca63321547571c1d749da88593f426da7cc2e5b6168cd25b32fd80efeea3 |
Hashes for surmise-0.2.1-cp39-cp39-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fb5279124ae8181c5e23b204dbabdb704d70876ad531b7c3785b043d94ef04da |
|
MD5 | fdba2200b5f1f34d454d40712a388d35 |
|
BLAKE2b-256 | 3f0878a98172af86ed590e6022bb492da5e256e76009def85a996a086cf43a20 |
Hashes for surmise-0.2.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 422bbfac71203fff01dd63fad9ff4799d34215af5bc30fd1858c3bb9ef3bd84e |
|
MD5 | 079a5eeaf3f527b06158bf9e6fec426f |
|
BLAKE2b-256 | 431edb8a95012581fd3c5e7ddc4aeec23ca4e1215a7e46ac56128fb720e28375 |
Hashes for surmise-0.2.1-cp39-cp39-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6df59079426c7c1fd61ea2f942e0d5c5ce1df1f2584b47c1ced3dcfa55938668 |
|
MD5 | cd2b6fd48121e8c78eebf824bef209ac |
|
BLAKE2b-256 | 0b7d226d5c991347114f93ce88a67041b2574bba40df216aa19cdcc281a86465 |
Hashes for surmise-0.2.1-cp38-cp38-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a4354e7189703cbc5d26816e5205a1ad9a3c50bc4c6fb9df87a12f8f57cf4734 |
|
MD5 | c0056828e51e9af134dc3d55f0995e4d |
|
BLAKE2b-256 | 26440a8b8f724443223a5b1ff81dd1adae89c990aee7ff1d3dea6795a77c49f0 |
Hashes for surmise-0.2.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 51d5c9964ce5e7f2c06268d6a8756c6acabd3cc4af34444713d2366b4d9568c5 |
|
MD5 | 0b6ba9b67fa34da65a84cf9f96e845f0 |
|
BLAKE2b-256 | 39ce048ce4d3c13f4dc2531f1641a96e2278be4c44831bee5fa6bd0c786b9a9e |
Hashes for surmise-0.2.1-cp38-cp38-macosx_10_9_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 41154e2b9c19ee6f1383861c8e12298e64b6eaec33038fd471e3b74582b9f8ef |
|
MD5 | 8941de7b25a6c2b90567be4ab284179b |
|
BLAKE2b-256 | 505058efdcb4ae7f79e60a3971e5bab50ddc79b34e4d03f498fb20f06d0e7f2d |