.. _method-multifidelity_sampling-numerical_solve-solver_metric: """"""""""""" solver_metric """"""""""""" Metric employed during numerical solutions in sampling-based multifidelity UQ methods. .. toctree:: :hidden: :maxdepth: 1 method-multifidelity_sampling-numerical_solve-solver_metric-average_estimator_variance method-multifidelity_sampling-numerical_solve-solver_metric-norm_estimator_variance method-multifidelity_sampling-numerical_solve-solver_metric-max_estimator_variance **Specification** - *Alias:* None - *Arguments:* None - *JSON argument key:* None **Child Keywords:** +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required/Optional | Description of Group | JSON Group Key | Dakota Keyword | Dakota Keyword Description | +=========================+========================+====================+================================+============================================================+ | Optional | | | `average_estimator_variance`__ | Utilize the estimator variance averaged over the QoI as | | | | | | the solver metric for sampling-based multifidelity | | | | | | methods. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `norm_estimator_variance`__ | Utilize a p-norm over the vector of QoI estimator | | | | | | variances as the solver metric for sampling-based | | | | | | multifidelity methods. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `max_estimator_variance`__ | Utilize the maximum estimator variance as the solver | | | | | | metric for sampling-based multifidelity methods. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: method-multifidelity_sampling-numerical_solve-solver_metric-average_estimator_variance.html __ method-multifidelity_sampling-numerical_solve-solver_metric-norm_estimator_variance.html __ method-multifidelity_sampling-numerical_solve-solver_metric-max_estimator_variance.html **Description** For sampling-based multifidelity UQ methods, this specification selects the metric to be used during numerical solutions for sample allocations per model. When there are multiple quantities of interest (QoI), the vector of QoI estimator variances needs to be converted to a scalar for use by the numerical solver. Options include the average, maximum, and p-norm of the QoI vector, with the default of average estimator variance. **Examples** .. tab:: Freeform .. code-block:: dakota method, approximate_control_variate acv_mf solver_metric norm_estimator_variance norm_order = 2 solution_mode online_pilot pilot_samples = 50 seed = 8674132 max_function_evaluations = 500 .. tab:: JSON .. code-block:: json { "method": [ { "approximate_control_variate": { "solver_metric": { "norm_estimator_variance": {"norm_order": 2} }, "solution_mode": {"online_pilot": {}}, "pilot_samples": [50], "seed_sequence": [8674132], "max_function_evaluations": 500 } } ] }