.. _method-fsu_cvt:

"""""""
fsu_cvt
"""""""


Design of Computer Experiments - Centroidal Voronoi Tessellation



**Topics**


package_fsudace, design_and_analysis_of_computer_experiments


.. toctree::
   :hidden:
   :maxdepth: 1

   method-fsu_cvt-samples
   method-fsu_cvt-seed
   method-fsu_cvt-fixed_seed
   method-fsu_cvt-latinize
   method-fsu_cvt-quality_metrics
   method-fsu_cvt-variance_based_decomp
   method-fsu_cvt-trial_type
   method-fsu_cvt-num_trials
   method-fsu_cvt-max_iterations
   method-fsu_cvt-model_pointer


**Specification**

- *Alias:* None

- *Arguments:* None


**Child Keywords:**

+-------------------------+--------------------+---------------------------+-----------------------------------------------+
| Required/Optional       | Description of     | Dakota Keyword            | Dakota Keyword Description                    |
|                         | Group              |                           |                                               |
+=========================+====================+===========================+===============================================+
| Optional                                     | `samples`__               | Number of samples for sampling-based methods  |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `seed`__                  | Seed of the random number generator           |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `fixed_seed`__            | Reuses the same seed value for multiple       |
|                                              |                           | random sampling sets                          |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `latinize`__              | Adjust samples to improve the discrepancy of  |
|                                              |                           | the marginal distributions                    |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `quality_metrics`__       | Calculate metrics to assess the quality of    |
|                                              |                           | quasi-Monte Carlo samples                     |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `variance_based_decomp`__ | Activates global sensitivity analysis based   |
|                                              |                           | on decomposition of response variance into    |
|                                              |                           | contributions from variables                  |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `trial_type`__            | Specify how the trial samples are generated   |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `num_trials`__            | The number of secondary sample points         |
|                                              |                           | generated to adjust the location of the       |
|                                              |                           | primary sample points                         |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `max_iterations`__        | Number of iterations allowed for optimizers   |
|                                              |                           | and adaptive UQ methods                       |
+----------------------------------------------+---------------------------+-----------------------------------------------+
| Optional                                     | `model_pointer`__         | Identifier for model block to be used by a    |
|                                              |                           | method                                        |
+----------------------------------------------+---------------------------+-----------------------------------------------+

.. __: method-fsu_cvt-samples.html
__ method-fsu_cvt-seed.html
__ method-fsu_cvt-fixed_seed.html
__ method-fsu_cvt-latinize.html
__ method-fsu_cvt-quality_metrics.html
__ method-fsu_cvt-variance_based_decomp.html
__ method-fsu_cvt-trial_type.html
__ method-fsu_cvt-num_trials.html
__ method-fsu_cvt-max_iterations.html
__ method-fsu_cvt-model_pointer.html



**Description**


The FSU Centroidal Voronoi Tessellation method ( ``fsu_cvt``)
produces a set of sample points that are
(approximately) a Centroidal Voronoi Tessellation. The primary feature of
such a set of points is that they have good volumetric spacing; the points
tend to arrange themselves in a pattern of cells that are roughly the
same shape.

To produce this set of points, an almost arbitrary set of
initial points is chosen, and then an internal set of
iterations is carried out. These iterations repeatedly replace
the current set of sample points by an estimate
of the centroids of the corresponding Voronoi subregions.
:cite:p:`Du99`.

The user may generally ignore the details of this internal iteration. If
control is desired, however, there are a few variables with which the user
can influence the iteration.
The user may specify:

- :dakkw:`method-fsu_cvt-max_iterations`, the number of iterations carried out
- :dakkw:`method-fsu_cvt-num_trials`, the number of secondary sample points generated to adjust the location of the primary sample points
- :dakkw:`method-fsu_cvt-trial_type`, which controls how these secondary sample points are generated

This method generates sets of uniform random variables on the
interval [0,1]. If the user specifies lower and upper bounds for a
variable, the [0,1] samples are mapped to the [lower, upper] interval.



**Theory**


This method is designed to generate samples with the goal of low discrepancy.
Discrepancy refers to the nonuniformity of the sample points
within the hypercube.

Discrepancy is defined as the difference between
the actual number and the expected number of points one would expect
in a particular set B (such as a hyper-rectangle within the unit
hypercube), maximized over all such sets.
Low discrepancy sequences tend to cover the
unit hypercube reasonably uniformly.

Centroidal Voronoi Tessellation
does very well volumetrically: it spaces the points fairly
equally throughout the space, so that the points cover the region
and are isotropically distributed with no directional bias in the
point placement. There are various measures of volumetric
uniformity which take into account the distances between
pairs of points, regularity measures, etc.
Note that Centroidal Voronoi Tessellation does not produce low-discrepancy sequences
in lower dimensions. The lower-dimension (such as 1-D)
projections of Centroidal Voronoi Tessellation can have high discrepancy.