.. _method-surrogate_based_uq: """""""""""""""""" surrogate_based_uq """""""""""""""""" Generic UQ method for constructing and interrogating a surrogate model. .. toctree:: :hidden: :maxdepth: 1 method-surrogate_based_uq-model_pointer method-surrogate_based_uq-seed method-surrogate_based_uq-fixed_seed method-surrogate_based_uq-samples_on_emulator method-surrogate_based_uq-sample_type method-surrogate_based_uq-rng method-surrogate_based_uq-probability_refinement method-surrogate_based_uq-final_moments method-surrogate_based_uq-response_levels method-surrogate_based_uq-probability_levels method-surrogate_based_uq-reliability_levels method-surrogate_based_uq-gen_reliability_levels method-surrogate_based_uq-distribution method-surrogate_based_uq-variance_based_decomp method-surrogate_based_uq-import_approx_points_file method-surrogate_based_uq-export_approx_points_file method-surrogate_based_uq-diagonal_covariance method-surrogate_based_uq-full_covariance method-surrogate_based_uq-id_method method-surrogate_based_uq-output method-surrogate_based_uq-final_solutions **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 | | | `model_pointer`__ | Identifier for model block to be used by a method | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `seed`__ | Seed of the random number generator | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `fixed_seed`__ | Reuses the same seed value for multiple random sampling | | | | | | sets | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `samples_on_emulator`__ | Number of samples at which to evaluate an emulator | | | | | | (surrogate) | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `sample_type`__ | Selection of sampling strategy | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `rng`__ | Selection of a random number generator | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `probability_refinement`__ | Allow refinement of probability and generalized | | | | | | reliability results using importance sampling | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `final_moments`__ | Output moments of the specified type and include them | | | | | | within the set of final statistics. | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `response_levels`__ | Values at which to estimate desired statistics for each | | | | | | response | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `probability_levels`__ | Specify probability levels at which to estimate the | | | | | | corresponding response value | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `reliability_levels`__ | Specify reliability levels at which the response values | | | | | | will be estimated | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `gen_reliability_levels`__ | Specify generalized relability levels at which to estimate | | | | | | the corresponding response value | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `distribution`__ | Selection of cumulative or complementary cumulative | | | | | | functions | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `variance_based_decomp`__ | Activates global sensitivity analysis based on | | | | | | decomposition of response variance into main, interaction, | | | | | | and total effects | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `import_approx_points_file`__ | Filename for points at which to evaluate the PCE/SC | | | | | | surrogate | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `export_approx_points_file`__ | Output file for surrogate model value evaluations | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional (Choose One) | Covariance Type | covariance_type | `diagonal_covariance`__ | Display only the diagonal terms of the covariance matrix | + + + +--------------------------------+------------------------------------------------------------+ | | | | `full_covariance`__ | Display the full covariance matrix | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `id_method`__ | Name the method block; helpful when there are multiple | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `output`__ | Control how much method information is written to the | | | | | | screen and output file | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Optional | | | `final_solutions`__ | Number of designs returned as the best solutions | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: method-surrogate_based_uq-model_pointer.html __ method-surrogate_based_uq-seed.html __ method-surrogate_based_uq-fixed_seed.html __ method-surrogate_based_uq-samples_on_emulator.html __ method-surrogate_based_uq-sample_type.html __ method-surrogate_based_uq-rng.html __ method-surrogate_based_uq-probability_refinement.html __ method-surrogate_based_uq-final_moments.html __ method-surrogate_based_uq-response_levels.html __ method-surrogate_based_uq-probability_levels.html __ method-surrogate_based_uq-reliability_levels.html __ method-surrogate_based_uq-gen_reliability_levels.html __ method-surrogate_based_uq-distribution.html __ method-surrogate_based_uq-variance_based_decomp.html __ method-surrogate_based_uq-import_approx_points_file.html __ method-surrogate_based_uq-export_approx_points_file.html __ method-surrogate_based_uq-diagonal_covariance.html __ method-surrogate_based_uq-full_covariance.html __ method-surrogate_based_uq-id_method.html __ method-surrogate_based_uq-output.html __ method-surrogate_based_uq-final_solutions.html **Description** As surrogate models by stochastic expansion migrate into the model specification, this method provides a general-purpose UQ method to interrogate the surrogate for generating statistics. This method must identify the surrogate of interest through its ``model_pointer``, distinguishing it from fully-integrated method specifications such as :dakkw:`method-polynomial_chaos`, :dakkw:`method-stoch_collocation`, and :dakkw:`method-function_train` that couple directly with a simulation model (and form the PCE, SC, FT surrogate approximations implicitly prior to using them for generating statistics).