.. _model-local_surrogate: """"""""""""""" local_surrogate """"""""""""""" Build a locally accurate surrogate from data at a single point .. toctree:: :hidden: :maxdepth: 1 model-local_surrogate-taylor_series model-local_surrogate-truth_model_pointer model-local_surrogate-id_surrogates model-local_surrogate-id_model model-local_surrogate-variables_pointer model-local_surrogate-responses_pointer model-local_surrogate-hierarchical_tagging **Specification** - *Alias:* None - *Arguments:* None - *JSON argument key:* None **Child Keywords:** +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required/Optional | Description of Group | JSON Group Key | Dakota Keyword | Dakota Keyword Description | +=========================+========================+====================+================================+============================================================+ | Required | | | `taylor_series`__ | Construct a Taylor Series expansion around a point | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required | | | `truth_model_pointer`__ | Pointer to specify a "truth" model, from which to | | | | | | construct a surrogate | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `id_surrogates`__ | Identifies the subset of the response functions by number | | | | | | that are to be approximated (the default is all | | | | | | functions). | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `id_model`__ | Give the model block an identifying name, in case of | | | | | | multiple model blocks | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `variables_pointer`__ | Specify which variables block will be included with this | | | | | | model block | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `responses_pointer`__ | Specify which reponses block will be used by this model | | | | | | block | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `hierarchical_tagging`__ | Enables hierarchical evaluation tagging | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: model-local_surrogate-taylor_series.html __ model-local_surrogate-truth_model_pointer.html __ model-local_surrogate-id_surrogates.html __ model-local_surrogate-id_model.html __ model-local_surrogate-variables_pointer.html __ model-local_surrogate-responses_pointer.html __ model-local_surrogate-hierarchical_tagging.html **Description** Local approximations use value, gradient, and possibly Hessian data from a single point to form a series expansion for approximating data in the vicinity of this point. The currently available local approximation is the ``taylor_series`` selection. The truth model to be used to generate the value/gradient/Hessian data used in the series expansion is identified through the required ``truth_model_pointer`` specification. The use of a model pointer (as opposed to an interface pointer) allows additional flexibility in defining the approximation. In particular, the derivative specification for the truth model may differ from the derivative specification for the approximation, and the truth model results being approximated may involve a model recursion (e.g., the values/gradients from a nested model).