1Blurb::
2Specifies the number of components to retain to explain the specified percent variance.
3
4Description::
5Dakota can calculate the principal components of the response matrix of
6N samples * L responses using the keyword \c principal_components.
7Principal components analysis (PCA) is a data reduction method.
8\c percent_variance_explained is a threshold that determines the number of components that are retained to explain at least that amount of variance.  For example, if the user specifies \c percent_variance_explained = 0.99, the number of components that accounts for at least 99 percent of the variance in the responses will be retained.  The default for this percentage is 0.95.  In many applications, only a few principal components explain the majority of the variance, resulting in significant data reduction.
9
10<b> Expected Outputs </b>
11
12<b> Usage Tips </b>
13\c percent_variance_explained should be a real number between 0.0 and 1.0.
14Typically, it will be between 0.9 and 1.0.
15
16Topics::
17Examples::
18\verbatim
19method,
20  sampling
21    sample_type lhs
22    samples = 100
23    principal_components
24    percent_variance_explained = 0.98
25\endverbatim
26Theory::
27There is an extensive statistical literature available on PCA.
28We recommend that the interested user peruse some of this in using the PCA capability.
29
30Faq::
31See_Also::
32