.. _method-centered_parameter_study: """""""""""""""""""""""" centered_parameter_study """""""""""""""""""""""" Samples variables along points moving out from a center point **Topics** :ref:`parameter_studies ` .. toctree:: :hidden: :maxdepth: 1 method-centered_parameter_study-model_pointer method-centered_parameter_study-id_method method-centered_parameter_study-output method-centered_parameter_study-final_solutions method-centered_parameter_study-step_vector method-centered_parameter_study-steps_per_variable **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 | | | `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 | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required | | | `step_vector`__ | Size of steps to be taken in each dimension of a centered | | | | | | parameter study | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ | Required | | | `steps_per_variable`__ | Number of steps to take in each dimension of a centered | | | | | | parameter study | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: method-centered_parameter_study-model_pointer.html __ method-centered_parameter_study-id_method.html __ method-centered_parameter_study-output.html __ method-centered_parameter_study-final_solutions.html __ method-centered_parameter_study-step_vector.html __ method-centered_parameter_study-steps_per_variable.html **Description** Dakota's centered parameter study computes response data sets along multiple coordinate-based vectors, one per parameter, centered about the initial values from the variables specification. This is useful for investigation of function contours with respect to each parameter individually in the vicinity of a specific point (e.g., post-optimality analysis for verification of a minimum), thereby avoiding the cost associated with a multidimensional grid. *Default Behavior* By default, the centered parameter study operates over all types of variables. The ``centered_parameter_study`` takes steps along each orthogonal dimension. Each dimension is treated independently. The number of steps are taken in each direction, so that the total number of points in the parameter study is :math:`1+ 2\sum{n}` . *Expected Outputs* A centered parameter study produces a set of responses for each parameter set that is generated. *Expected HDF5 Output* If Dakota was built with HDF5 support and run with the :dakkw:`environment-results_output-hdf5` keyword, this method writes the following results to HDF5: - :ref:`hdf5_results-pstudies` - :ref:`hdf5_results-var_slices` **Examples** The following example is a good comparison to the examples on :dakkw:`method-multidim_parameter_study` and :dakkw:`method-vector_parameter_study`. .. tab:: Freeform .. code-block:: dakota # tested on Dakota 6.0 on 140501 environment tabular_data tabular_data_file = 'rosen_centered.dat' method centered_parameter_study steps_per_variable = 5 4 step_vector = 0.4 0.5 model single variables continuous_design = 2 initial_point = 0 0 descriptors = 'x1' "x2" interface analysis_driver = 'rosenbrock' fork responses response_functions = 1 no_gradients no_hessians .. tab:: JSON .. code-block:: json { "environment": { "tabular_data": { "tabular_data_file": "rosen_centered.dat" } }, "method": [ { "centered_parameter_study": { "steps_per_variable": [ 5, 4 ], "step_vector": [ 0.4, 0.5 ] } } ], "model": [ { "single": {} } ], "variables": [ { "continuous_design": { "initial_point": [ 0, 0 ], "descriptors": [ "x1", "x2" ], "count": 2 } } ], "interface": [ { "analysis_drivers": { "drivers": [ "rosenbrock" ], "interface_type": { "fork": {} } } } ], "responses": [ { "response_type": { "response_functions": { "count": 1 } }, "gradient_type": { "no_gradients": true }, "hessian_type": { "no_hessians": true } } ] }