.. _method-sampling-variance_based_decomp-vbd_sampling_method-binned: """""" binned """""" Computes Sobol' main effects using a binned approach .. toctree:: :hidden: :maxdepth: 1 method-sampling-variance_based_decomp-vbd_sampling_method-binned-num_bins **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 | | | `num_bins`__ | Number of bins used to compute the variance-based | | | | | | decomposition | +-------------------------+------------------------+--------------------+--------------------------------+------------------------------------------------------------+ .. __: method-sampling-variance_based_decomp-vbd_sampling_method-binned-num_bins.html **Description** Uses unstructured input-output samples to estimate main effect indices. It cannot compute total indices. **Expected Output** Sensitivity indices for main effects *only* will be reported. Main effects (roughly) represent the percent contribution of each individual variable to the variance in the model response. **Examples** .. tab:: Freeform .. code-block:: dakota method, sampling sample_type lhs samples = 100 variance_based_decomp vbd_sampling_method binned .. tab:: JSON .. code-block:: json { "method": [ { "sampling": { "sample_type": {"lhs": true}, "samples": 100, "variance_based_decomp": { "vbd_sampling_method": {"binned": {}} } } } ] } .. tab:: Freeform :new-set: .. code-block:: dakota method, import_points import_points_file "all_samples.dat" variance_based_decomp .. tab:: JSON .. code-block:: json { "method": [ { "import_points": { "import_points_file": {"filename": "all_samples.dat"}, "variance_based_decomp": {} } } ] } Note that since the ``import_points`` method only supports the binned approach, ``vbd_sampling_method`` is not specified. **Theory** The binned approach to computing Sobol' main effect indices is introduced in :cite:p:`Li16`. As opposed to pick-and-freeze approaches like :cite:p:`Sal04`, it does not require a specific sampling structure. Given a set of randomly-generated input-output samples, it computes the main effect index by binning samples, computing a sample statistic for each bin, then computing another sample statistic over the bins. Two algorithms are detailed in :cite:p:`Li16`: computing a sample expectation for each bin, then a sample variance, or computing a sample variance for each bin, then an expectation. The second algorithm is implemented in Dakota.