These functions are under development. Please email the author before using them for published results.
a.score(x, n.sim=10, ...)optim.a.score(x, n.pca=1:ncol(x$tab), smart=TRUE, n=10, plot=TRUE,
n.sim=10, n.da=length(levels(x$grp)), ...)
=== a.score ===
a.score returns a list with the following components:
a matrix of a-scores with groups in columns and simulations in row.
a vector giving the mean a-score for each population.
the overall mean a-score.
=== optim.a.score ===
optima.score returns a list with the following components:
a list giving the mean a-score of the populations for each number of retained PC (each element of the list corresponds to a number of retained PCs).
a vector giving the overall mean a-score for each number of retained PCs.
(only when smart is TRUE) the predictions of the
spline, given in x and y coordinates.
the optimal number of PCs to be retained.
a dapc object.
a vector of integers indicating the number of axes retained in the
Principal Component Analysis (PCA) steps of DAPC. nsim DAPC
will be run for each value in n.pca, unless the smart approach
is used (see details).
a logical indicating whether a smart, less
computer-intensive approach should be used (TRUE, default) or not
(FALSE). See details section.
an integer indicating the numbers of values spanning the
range of n.pca to be used in the smart approach.
a logical indicating whether the results should be
displayed graphically (TRUE, default) or not (FALSE).
an integer indicating the number of simulations to
be performed for each number of retained PC.
an integer indicating the number of axes retained in the
Discriminant Analysis step.
further arguments passed to other methods; currently unused..
Thibaut Jombart t.jombart@imperial.ac.uk
The Discriminant Analysis of Principal Components seeks a reduced space inside which observations are best discriminated into pre-defined groups. One way to assess the quality of the discrimination is looking at re-assignment of individuals to their prior group, successful re-assignment being a sign of strong discrimination.
However, when the original space is very large, ad hoc solutions can be found, which discriminate very well the sampled individuals but would perform poorly on new samples. In such a case, DAPC re-assignment would be high even for randomly chosen clusters. The a-score measures this bias. It is computed as (Pt-Pr), where Pt is the reassignment probability using the true cluster, and Pr is the reassignment probability for randomly permuted clusters. A a-score close to one is a sign that the DAPC solution is both strongly discriminating and stable, while low values (toward 0 or lower) indicate either weak discrimination or instability of the results.
The a-score can serve as a criterion for choosing the optimal number of
PCs in the PCA step of DAPC, i.e. the number of PC maximizing the
a-score. Two procedures are implemented in optim.a.score. The
smart procedure selects evenly distributed number of PCs in a
pre-defined range, compute the a-score for each, and then interpolate
the results using splines, predicting an approximate optimal number of
PCs. The other procedure (when smart is FALSE) performs the
computations for all number of PCs request by the user. The 'optimal'
number is then the one giving the highest mean a-score (computed over
the groups).
Jombart T, Devillard S and Balloux F (2010) Discriminant analysis of principal components: a new method for the analysis of genetically structured populations. BMC Genetics11:94. doi:10.1186/1471-2156-11-94
- find.clusters: to identify clusters without prior.
- dapc: the Discriminant Analysis of Principal
Components (DAPC)