spectR: Spectral density plot of a phylogeny

spectRR Documentation

Spectral density plot of a phylogeny

Description

Computes the spectra of eigenvalues for the modified graph Laplacian of a phylogenetic tree, identifies the spectral gap, then convolves the eigenvalues with a Gaussian kernel, and plots them alongside all eigenvalues ranked in descending order.

Usage

spectR(phylo, meth=c("standard"),zero_bound=F)

Arguments

phylo

an object of type 'phylo' (see ape documentation)

meth

the method used to compute the spectral density, which can either be "standard" or "normal". If set to "standard", computes the unnormalized version of the spectral density. If set to "normal", computes the spectral density normalized to the degree matrix (see the associated paper for an explanation)

zero_bound

if false, eigenvalues less than one are discarded

Details

Note that the eigengap should in principle be computed with the "standard" option

Value

a list with the following components:

eigenvalues

the vector of eigenvalues

principal_eigenvalue

the largest (or principal) eigenvalue of the spectral density profile

asymmetry

the skewness of the spectral density profile

peak_height

the largest y-axis value of the spectral density profile

eigengap

the position of the largest difference between eigenvalues, giving the number of modalities in the tree

Author(s)

E Lewitus

References

Lewitus, E., Morlon, H., Characterizing and comparing phylogenies from their Laplacian spectrum, bioRxiv doi: http://dx.doi.org/10.1101/026476

See Also

plot_spectR, JSDtree, BICompare

Examples

data(Cetacea)
spectR(Cetacea,meth="standard",zero_bound=FALSE)

hmorlon/PANDA documentation built on March 8, 2024, 8:36 p.m.