.. _model-random_field-build_source:

""""""""""""
build_source
""""""""""""


Specify how the random field will be built:
from a data file, from simulation
runs, or from a covariance matrix.
THIS IS AN EXPERIMENTAL CAPABILITY.


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

   model-random_field-build_source-rf_data_file
   model-random_field-build_source-dace_method_pointer
   model-random_field-build_source-analytic_covariance


**Specification**

- *Alias:* None

- *Arguments:* None


**Child Keywords:**

+-------------------------+--------------------+-------------------------+-----------------------------------------------+
| Required/Optional       | Description of     | Dakota Keyword          | Dakota Keyword Description                    |
|                         | Group              |                         |                                               |
+=========================+====================+=========================+===============================================+
| Required (Choose One)   | Build Data Source  | `rf_data_file`__        | Specify that the random field will be built   |
|                         |                    |                         | from a file of data. THIS IS AN EXPERIMENTAL  |
|                         |                    |                         | CAPABILITY.                                   |
|                         |                    +-------------------------+-----------------------------------------------+
|                         |                    | `dace_method_pointer`__ | Pointer to a DACE method for purposes of      |
|                         |                    |                         | generating an ensemble of field responses to  |
|                         |                    |                         | be used in estimating a random field model.   |
|                         |                    |                         | THIS IS AN EXPERIMENTAL CAPABILITY.           |
|                         |                    +-------------------------+-----------------------------------------------+
|                         |                    | `analytic_covariance`__ | Use an analytic covariance function for the   |
|                         |                    |                         | purposes of generating a random field model.  |
|                         |                    |                         | THIS IS AN EXPERIMENTAL CAPABILITY.           |
+-------------------------+--------------------+-------------------------+-----------------------------------------------+

.. __: model-random_field-build_source-rf_data_file.html
__ model-random_field-build_source-dace_method_pointer.html
__ model-random_field-build_source-analytic_covariance.html



**Description**


As part of the capability to generate a random field representation, the user
needs to specify the data used to generate the random field representation.
This data may reside in a data file, it may be generated by running a set of simulations and generating field responses, or it
may be generated by a covariance matrix defined over a mesh.
THIS IS AN EXPERIMENTAL CAPABILITY UNDER ACTIVE DEVELOPMENT.

*Default Behavior*
Currently, the ``build_source`` that is fully working is the
``dace_method_pointer``.  The others are not fully operational.