Dakota Reference Manual: nested

| Dakota Reference Manual Version 6.15 Explore and Predict with Confidence

- Main Page
- Related Pages

All Pages
nested

A model whose responses are computed through the use of a sub-iterator

## Specification

Alias: none

Argument(s): none

Child Keywords:

| Required/Optional | Description of Group | Dakota Keyword | Dakota Keyword Description
--- | --- | --- | --- | ---
| Optional | optional_interface_pointer | Pointer to interface that provides non-nested responses
| Required | sub_method_pointer | The `sub_method_pointer` specifies the method block for the sub-iterator

## Description

Instead of appealing directly to a primary interface, a nested model maps variables to responses by executing a secondary iterator, or a "sub-iterator". In other words, a function evaluation of the primary study consists of a solution of an entire secondary study - potentially many secondary function evaluations.

The sub-iterator in turn operates on a sub-model. The sub-iterator responses may be combined with non-nested contributions from an optional interface specification.

A `sub_method_pointer` must be provided in order to specify the method block describing the sub-iterator. The remainder of the model is specified under that keyword.

A `optional_interface_pointer` points to the interface specification and `optional_interface_responses_pointer` points to a responses specification describing the data to be returned by this interface. This interface is used to provide non-nested data, which is then combined with data from the nested iterator using the `primary_response_mapping`. (See the discussions for the `sub_method_pointer` and `optional_interface_pointer` keywords.)

## See Also

These keywords may also be of interest:

- single
- surrogate