.. _model-ensemble_surrogate-ordered_model_fidelities: """""""""""""""""""""""" ordered_model_fidelities """""""""""""""""""""""" Specification of an hierarchy of model fidelities, ordered from low to high. .. toctree:: :hidden: :maxdepth: 1 model-ensemble_surrogate-ordered_model_fidelities-correction **Specification** - *Alias:* model_fidelity_sequence - *Arguments:* STRING ARRAY - *JSON argument key:* pointers **Child Keywords:** +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required/Optional | Description of Group | JSON Group Key | Dakota Keyword | Dakota Keyword Description | +=========================+========================+====================+================================+============================================================+ | Optional | | | `correction`__ | Correction approaches for surrogate models | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: model-ensemble_surrogate-ordered_model_fidelities-correction.html **Description** An ensemble surrogate model can manage an ordered set of model fidelities, each of which may in turn involve multiple discretization levels (in the case of a simulation model) or additional model recursions. The ordering is assumed to be from lowest fidelity to highest fidelity, as dictated by an accuracy versus cost trade-off. Corresponding sequence specifications within methods (e.g., ``quadrature_order_sequence``, ``sparse_grid_level_sequence``, ``expansion_order_sequence``, etc. within stochastic expansion methods) should be synchronized with this model order. *Additional Discussion* Internal to the hierarchical usage of an ensemble surrogate model, only one low fidelity model instance and one high fidelity model instance are active at any given time, although various optimization and UQ algorithms can be used to traverse deep multilevel and multifidelity hierarchies by activating different model combinations and different response modes within the hierarchical model infrastructure. **Examples** .. tab:: Freeform .. code-block:: dakota model id_model = 'HIERARCH' ensemble_surrogate ordered_model_fidelities = 'LF' 'MF' 'HF' correction additive zeroth_order model id_model = 'LF' single interface_pointer = 'LF_DRIVER' model id_model = 'MF' single interface_pointer = 'MF_DRIVER' model id_model = 'HF' single interface_pointer = 'HF_DRIVER' .. tab:: JSON .. code-block:: json { "model": [ { "ensemble_surrogate": { "id_model": "HIERARCH", "ensemble": { "ordered_model_fidelities": { "pointers": ["LF", "MF", "HF"], "correction": { "correction_type": { "additive": true }, "correction_order": { "zeroth_order": true } } } } } }, { "single": { "id_model": "LF", "interface_pointer": "LF_DRIVER" } }, { "single": { "id_model": "MF", "interface_pointer": "MF_DRIVER" } }, { "single": { "id_model": "HF", "interface_pointer": "HF_DRIVER" } } ] }