Learn R Programming

phytools (version 0.4-45)

phyl.pca: Phylogenetic principal components analysis

Description

This function performs phylogenetic PCA (e.g., Revell 2009; Evolution).

Usage

phyl.pca(tree, Y, method="BM", mode="cov")
## S3 method for class 'phyl.pca':
biplot(x, ...)

Arguments

tree
phylogeny as an object of class "phylo".
Y
data matrix with traits in columns.
method
method to obtain the correlation structure: can be "BM" or "lambda".
mode
is the mode for the PCA: can be "cov" or "corr".
x
object of class "phyl.pca" for biplot.phyl.pca.
...
for S3 plotting method biplot.phyl.pca, other arguments to be passed to biplot.

Value

  • An object of class phyl.pca which is a list with some or all of the following components:
  • Evaldiagonal matrix of eigenvalues.
  • Evecmatrix with eigenvectors in columns.
  • Smatrix with scores.
  • Lmatrix with loadings.
  • lambdafitted value of lambda (method="lambda" only).
  • logLlog-likelihood for lambda model (method="logL" only).

Details

If method="lambda" $\lambda$ is optimized on the interval (0,1) using optimize. S3 methods (print, summary, and biplot are modified from code provided by Joan Maspons and are based on the same methods for objects of class "prcomp".

References

Revell, L. J. (2009) Size-correction and principal components for interspecific comparative studies. Evolution, 63, 3258-3268. Revell, L. J. (2012) phytools: An R package for phylogenetic comparative biology (and other things). Methods Ecol. Evol., 3, 217-223.

See Also

phyl.cca, phyl.resid