dakota
  • Getting Started
  • Using Dakota
    • About Dakota
    • Dakota Beginner’s Tutorial
    • Examples
    • Coupling Dakota to a Simulation
    • Dakota Input File
    • Running Dakota
    • Dakota Output
    • Study Types
    • Topics
    • Advanced Topics
    • Dakota Theory
    • Keyword Reference
      • environment
      • method
        • id_method
        • output
        • final_solutions
        • hybrid
        • multi_start
        • pareto_set
        • branch_and_bound
        • surrogate_based_local
        • surrogate_based_global
        • dot_frcg
        • dot_mmfd
        • dot_bfgs
        • dot_slp
        • dot_sqp
        • conmin_frcg
        • conmin_mfd
        • dl_solver
        • npsol_sqp
        • nlssol_sqp
        • nlpql_sqp
        • optpp_cg
        • optpp_q_newton
        • optpp_fd_newton
        • optpp_g_newton
        • optpp_newton
        • optpp_pds
        • demo_tpl
        • rol
        • asynch_pattern_search
        • mesh_adaptive_search
          • initial_delta
          • variable_tolerance
          • function_precision
          • seed
          • history_file
          • display_format
          • variable_neighborhood_search
          • neighbor_order
          • display_all_evaluations
          • use_surrogate
            • inform_search
            • optimize
          • max_iterations
          • max_function_evaluations
          • scaling
          • model_pointer
        • nowpac
        • snowpac
        • moga
        • soga
        • coliny_pattern_search
        • coliny_solis_wets
        • coliny_cobyla
        • coliny_direct
        • coliny_ea
        • coliny_beta
        • nl2sol
        • nonlinear_cg
        • ncsu_direct
        • genie_opt_darts
        • genie_direct
        • efficient_global
        • surrogate_based_uq
        • function_train
        • multifidelity_function_train
        • multilevel_function_train
        • polynomial_chaos
        • multifidelity_polynomial_chaos
        • multilevel_polynomial_chaos
        • stoch_collocation
        • multifidelity_stoch_collocation
        • sampling
        • multilevel_sampling
        • multifidelity_sampling
        • multilevel_multifidelity_sampling
        • approximate_control_variate
        • multilevel_blue
        • importance_sampling
        • gpais
        • adaptive_sampling
        • pof_darts
        • rkd_darts
        • global_evidence
        • global_interval_est
        • bayes_calibration
        • dace
        • fsu_cvt
        • psuade_moat
        • local_evidence
        • local_interval_est
        • local_reliability
        • global_reliability
        • fsu_quasi_mc
        • vector_parameter_study
        • list_parameter_study
        • centered_parameter_study
        • multidim_parameter_study
        • richardson_extrap
      • model
      • variables
      • interface
      • responses
  • Using Dakota GUI
  • Using External Tools
  • Compiling Dakota
  • Developing Dakota
  • Miscellaneous
dakota

Sandia National Laboratories

  • Search Sandia.gov
  • All Sandia Websites
  • Using Dakota
  • Keyword Reference
  • method
  • mesh_adaptive_search
  • use_surrogate
  • inform_search
  • View page source

inform_search

Surrogate informs evaluation order in mesh adaptive search

Specification

  • Alias: None

  • Arguments: None

Description

When inform_search is specified with use_surrogate, mesh_adaptive_search uses the surrogate to sort list of trial points and subsequently the true function is evaluated on the most promising points first. Both true function and surrogate are used interchangeably within the method.

Default Behavior

inform_search is not the default surrogate usage mode.

Expected Output

The user can expect to see both the number of true model evaluations and the number of approximation (i.e., surrogate) evaluations reported in the Dakota screen output. The former captures the sum of truth evaluations done for the surrogate construction and for the optimization.

Usage Tips

When inform_search is specified, the maximum_function_evaluations keyword applies to only the optimization method and does not account for evaluations needed to construct the surrogate. If the user has a strict evaluation budget, they should set maximum_function_evaluations such that evaluation budget = number of evaluations to construct surrogate + maximum_function_evaluations.

Examples

The following example shows the syntax used to set use_surrogate to optimize.

method,
 mesh_adaptive_search
 model_pointer = 'SURROGATE'
 use_surrogate inform_search

model,
 id_model = 'SURROGATE'
 surrogate global
 polynomial quadratic
 dace_method_pointer = 'SAMPLING'

variables,
 continuous_design = 3
   initial_point   -1.0    1.5   2.0
   upper_bounds    10.0   10.0  10.0
   lower_bounds   -10.0  -10.0 -10.0
   descriptors      'x1'  'x2'  'x3'
 discrete_design_range = 2
   initial_point      2     2
   lower_bounds       1     1
   upper_bounds       4     9
   descriptors      'y1'   'y2'
       discrete_design_set
         real = 2
           elements_per_variable = 4 5
           elements = 1.2 2.3 3.4 4.5 1.2 3.3 4.4 5.5 7.7
           descriptors      'y3'   'y4'
         integer = 2
           elements_per_variable = 2 2
           elements = 4 7 8 9
           descriptors      'z1'   'z2'

method,
 id_method = 'SAMPLING'
 model_pointer = 'TRUTH'
 sampling
   samples = 55

model,
 id_model = 'TRUTH'
 single
   interface_pointer = 'TRUE_FN'

interface,
 id_interface = 'TRUE_FN'
       direct
   analysis_driver = 'text_book'

responses,
 objective_functions = 1
 no_gradients
 no_hessians

The following will appear toward the end of the screen output when Dakota is run on this example. The number of true function evaluations includes the 55 evaluations that were done to construct the surrogate (as specified in the SAMPLING method block) plus the number of truth evaluations done by mesh_adaptive_search.

<<<<< Function evaluation summary (APPROX_INTERFACE): 1660 total (1660 new, 0 duplicate)
<<<<< Function evaluation summary (TRUE_FN): 795 total (795 new, 0 duplicate)
Previous Next

Exceptional service in the national interest

© 2023 National Technology and Engineering Solutions of Sandia, LLC. | Questions & Comments | Privacy & Security

U.S. Department of Energy National Nuclear Security Administration

Sandia National Laboratories is a multimission laboratory managed and operated by National Technology and Engineering Solutions of Sandia, LLC., a wholly owned subsidiary of Honeywell International, Inc., for the U.S. Department of Energy’s National Nuclear Security Administration under contract DE-NA-0003525.