.. _model-surrogate-global-experimental_gaussian_process:

"""""""""""""""""""""""""""""
experimental_gaussian_process
"""""""""""""""""""""""""""""


Use the Gaussian process regression surrogate from the surrogates module


.. toctree::
   :hidden:
   :maxdepth: 1

   model-surrogate-global-experimental_gaussian_process-trend
   model-surrogate-global-experimental_gaussian_process-num_restarts
   model-surrogate-global-experimental_gaussian_process-nugget
   model-surrogate-global-experimental_gaussian_process-find_nugget
   model-surrogate-global-experimental_gaussian_process-options_file
   model-surrogate-global-experimental_gaussian_process-export_approx_variance_file
   model-surrogate-global-experimental_gaussian_process-export_model
   model-surrogate-global-experimental_gaussian_process-import_model


**Specification**

- *Alias:* None

- *Arguments:* None


**Child Keywords:**

+-------------------------+--------------------+---------------------------------+-----------------------------------------------+
| Required/Optional       | Description of     | Dakota Keyword                  | Dakota Keyword Description                    |
|                         | Group              |                                 |                                               |
+=========================+====================+=================================+===============================================+
| Optional                                     | `trend`__                       | This keyword enables the use of deterministic |
|                                              |                                 | polynomial trend function                     |
+----------------------------------------------+---------------------------------+-----------------------------------------------+
| Optional                                     | `num_restarts`__                | Number of optimization restarts for L-BFGS-B  |
+-------------------------+--------------------+---------------------------------+-----------------------------------------------+
| Optional (Choose One)   | Nugget             | `nugget`__                      | Value for the fixed nugget parameter          |
|                         |                    +---------------------------------+-----------------------------------------------+
|                         |                    | `find_nugget`__                 | Use regression to estimate the nugget.        |
+-------------------------+--------------------+---------------------------------+-----------------------------------------------+
| Optional                                     | `options_file`__                | Filename for a YAML file that specifies       |
|                                              |                                 | Gaussian process options                      |
+----------------------------------------------+---------------------------------+-----------------------------------------------+
| Optional                                     | `export_approx_variance_file`__ | Output file for surrogate model variance      |
|                                              |                                 | evaluations                                   |
+----------------------------------------------+---------------------------------+-----------------------------------------------+
| Optional                                     | `export_model`__                | Exports surrogate model in user-specified     |
|                                              |                                 | format(s)                                     |
+----------------------------------------------+---------------------------------+-----------------------------------------------+
| Optional                                     | `import_model`__                | Import surrogate model from archive file      |
+----------------------------------------------+---------------------------------+-----------------------------------------------+

.. __: model-surrogate-global-experimental_gaussian_process-trend.html
__ model-surrogate-global-experimental_gaussian_process-num_restarts.html
__ model-surrogate-global-experimental_gaussian_process-nugget.html
__ model-surrogate-global-experimental_gaussian_process-find_nugget.html
__ model-surrogate-global-experimental_gaussian_process-options_file.html
__ model-surrogate-global-experimental_gaussian_process-export_approx_variance_file.html
__ model-surrogate-global-experimental_gaussian_process-export_model.html
__ model-surrogate-global-experimental_gaussian_process-import_model.html



**Description**


This Gaussian process implementation is contained in Dakota's surrogates module
and is considered experimental. It uses gradient-based optimization with
restarts to determine hyperparmeters and trend coefficients. Nugget and trend
estimation are optional.