.. _method-multilevel_sampling-allocation_target: """"""""""""""""" allocation_target """"""""""""""""" Allocation statistics/target for the MLMC sample allocation. .. toctree:: :hidden: :maxdepth: 1 method-multilevel_sampling-allocation_target-mean method-multilevel_sampling-allocation_target-variance method-multilevel_sampling-allocation_target-standard_deviation method-multilevel_sampling-allocation_target-scalarization **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 | | | `mean`__ | Fit MLMC sample allocation to control the variance of the | | | | | | estimator for the mean. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `variance`__ | Fit MLMC sample allocation to control the variance of the | | | | | | estimator for the variance. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `standard_deviation`__ | Fit MLMC sample allocation to control the variance of the | | | | | | estimator for the standard deviation. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `scalarization`__ | Fit MLMC sample allocation to a mixture of terms of means | | | | | | and standard deviations. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: method-multilevel_sampling-allocation_target-mean.html __ method-multilevel_sampling-allocation_target-variance.html __ method-multilevel_sampling-allocation_target-standard_deviation.html __ method-multilevel_sampling-allocation_target-scalarization.html **Description** Computes the variance of the estimator for a given statistics/target and fits sample allocation by solving the corresponding optimization problem. The ``allocation_target`` specification supports options of ``mean`` (default), ``variance`` an analytic approximation is available. Additionally, a numerical optimization can be used in that case, see ``variance`` option :dakkw:`method-multilevel_sampling-allocation_target-variance-optimization`. *Default Behavior* "mean" **Examples** The following method block .. tab:: Freeform .. code-block:: dakota method, model_pointer = 'HIERARCH' multilevel_sampling pilot_samples = 20 seed = 1237 convergence_tolerance = .01 allocation_target = variance .. tab:: JSON .. code-block:: json { "method": [ { "multilevel_sampling": { "model_pointer": "HIERARCH", "pilot_samples": [20], "seed_sequence": [1237], "convergence_tolerance": { "value": 0.01 }, "allocation_target": { "variance": {} } } } ] } uses the variance as sample allocation target by computing its variance.