# scikit-gpuppy

version 0.9.3

Gaussian Process Uncertainty Propagation with PYthon

Homepage: https://github.com/snphbaum/scikit-gpuppy
PyPI: http://pypi.python.org/pypi/scikit-gpuppy
People: Philipp Baumgaertel

### Description

https://github.com/snphbaum/scikit-gpuppy

This package provides means for modeling functions and simulations using Gaussian processes (aka Kriging, Gaussian random fields, Gaussian random functions).
Additionally, uncertainty can be propagated through the Gaussian processes.

.. note::
\tThe Gaussian process regression and uncertainty propagation are based on Girard's thesis [#]_.

\tAn extension to speed up GP regression is based on Snelson's thesis [#]_.

\t.. warning::
\t\tThe extension based on Snelson's work is already usable but not as fast as it should be.
\t\tAdditionally, the uncertainty propagation does not yet work with this extension.

\tAn additional extension for Inverse Uncertainty Propagation is based on my paper (and upcoming PhD thesis) [#]_.

A simulation is seen as a function :math:f(x)+\\epsilon (:math:x \\in \\mathbb{R}^n) with additional random error :math:\\epsilon \\sim \\mathcal{N}(0,v).
This optional error is due to the stochastic nature of most simulations.

The *GaussianProcess* module uses regression to model the simulation as a Gaussian process.

The *UncertaintyPropagation* module allows for propagating uncertainty
:math:x \\sim \\mathcal{N}(\\mu,\\Sigma) through the Gaussian process to estimate the output uncertainty of the simulation.

The *FFNI* and *TaylorPropagation* modules provide classes for propagating uncertainty through deterministic functions.

The *InverseUncertaintyPropagation* module allows for propagating the desired
output uncertainty of the simulation backwards through the Gaussian Process.
This assumes that the components of the input :math:x are estimated from samples using maximum likelihood estimators.
Then, the inverse uncertainty propagation calculates the optimal sample sizes for estimating :math:x that lead to the desired output uncertainty of the simulation.

.. [#] Girard, A. Approximate Methods for Propagation of Uncertainty with Gaussian Process Models, University of Glasgow, 2004
.. [#] Snelson, E. L. Flexible and efficient Gaussian process models for machine learning, Gatsby Computational Neuroscience Unit, University College London, 2007
.. [#] Baumgaertel, P.; Endler, G.; Wahl, A. M. & Lenz, R. Inverse Uncertainty Propagation for Demand Driven Data Acquisition, Proceedings of the 2014 Winter Simulation Conference, IEEE Press, 2014, 710-721

### Installation

#### Using pip

You can install scikit-gpuppy for yourself from the terminal by running:

pip install --user scikit-gpuppy

If you want to install it for all users on your machine, do:

pip install scikit-gpuppy
On Linux, do sudo pip install scikit-gpuppy.

If you don't yet have the pip tool, you can get it following these instructions.

This package was discovered in PyPI.