gpCAM is a code for autonomous data acquisition
Project description
gpCAM
gpCAM (gpcam.lbl.gov) is an API and software designed to make advanced Gaussian Process function approximation and autonomous data acquisition/Bayesian Optimization for experiments and simulations more accurate, faster, simpler, and more widely available. The tool is based on a flexible and powerful Gaussian process regression at the core. The flexibility stems from the modular design of gpCAM which allows the user to implement and import their own Python functions to customize and control almost every aspect of the software. That makes it possible to easily tune the algorithm to account for various kinds of physics and other domain knowledge and to identify and find interesting features, in Euclidean and non-Euclidean spaces. A specialized function optimizer in gpCAM can take advantage of HPC architectures for fast analysis time and reactive autonomous data acquisition. gpCAM broke a 2019 record for the largest exact GP ever run! Below you can see a simple example of how to set up an autonomous experimentation loop.
Usage
The following demonstrates a simple usage of the gpCAM API (see interactive demo).
!pip install gpcam
from gpcam.autonomous_experimenter import AutonomousExperimenterGP
import numpy as np
def instrument(data):
for entry in data:
entry["y_data"] = np.sin(np.linalg.norm(entry["x_data"]))
return data
##set up your parameter space
parameters = np.array([[3.0,45.8],
[4.0,47.0]])
##set up some hyperparameters, if you have no idea, set them to 1 and make the training bounds large
init_hyperparameters = np.array([1,1,1])
hyperparameter_bounds = np.array([[0.01,100],[0.01,100.0],[0.01,100]])
##let's initialize the autonomous experimenter ...
my_ae = AutonomousExperimenterGP(parameters, init_hyperparameters,
hyperparameter_bounds,instrument_function = instrument,
init_dataset_size=10, info=False)
#...train...
my_ae.train()
#...and run. That's it. You successfully executed an autonomous experiment.
my_ae.go(N = 100)
Credits
Main Developer: Marcus Noack (MarcusNoack@lbl.gov) Many people from across the DOE national labs (especially BNL) have given insights that led to the code in it's current form. See AUTHORS for more details on that.
======= History
6.0.0 (2020-10-26)
- First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gpcam-8.0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 023d80911b105689a49fe766c1442bd61f13b6be65b467b8dcbbaddcdd8ba3d6 |
|
MD5 | a5faff8d435c1b1493e079723b198225 |
|
BLAKE2b-256 | 5ef8514cee2bda16d121b0937338fcd57795f38ba52a1fa975bf55953d2f2d5a |