Description Usage Arguments Value Author(s) References See Also Examples
View source: R/PhyloMeasures.R
Calculates the p-values of the core ancestor cost (CAC) measure for sets of tips on a phylogeny. The p-values can be calculated under two different null models which maintain species richness. The CAC is calculated by identifying the node in the tree that is the most recent common ancestor of at least chi proportion of the tips in the set, where chi is an input parameter larger than 0.5. The CAC is the distance of this node from the root of the tree.
1 2 | cac.pvalues(tree, matrix, chi, null.model="uniform",
abundance.weights, reps=1000, seed)
|
tree |
A phylo tree object |
matrix |
A matrix with binary (0/1) values, where each row represents a tip set. Each column name in the matrix must match a tip label on the input tree. If not all values in the matrix are binary, we consider two cases; if the matrix contains only non-negative values, all values are coerced to binary ones and a warning message is printed. If the matrix contains at least one negative value, the function throws an error. |
chi |
A number in the interval (0.5,1] |
null.model |
A character vector (string) that defines which null model is used for computing the p-values of the measure. There are two possible null models that can be used for computing the p-values: these are "uniform" and "sequential". Both models maintain species richness. More specifically, the available models are defined as follows:
This argument is optional, and its default value is set to "uniform". |
abundance.weights |
A vector of positive numeric values. These are the abundance weights that will be used if option "sequential" is selected. The names stored at the vector must match the names of the tips in the tree. This argument is redundant if the "uniform" model is selected. |
reps |
An integer that defines the number of Monte-Carlo random repetitions that will be performed when using the "sequential" model. This argument is redundant if the other null model is selected. |
seed |
A positive integer that defines the random seed used in the Monte-Carlo randomizations of the "sequential" model. This argument is optional, and becomes redundant if the other null model is selected. |
A vector which stores the computed CAC p-values. The i-th entry in this vector stores the CAC p-value of the i-th row in the input matrix.
Constantinos Tsirogiannis (tsirogiannis.c@gmail.com)
Tsirogiannis, C. and B. Sandel. 2015. PhyloMeasures: A package for computing phylogenetic biodiversity measures and their statistical moments. Ecography, doi: 10.1111/ecog.01814, 2015.
Tsirogiannis, C., B. Sandel and A. Kalvisa. 2014. New algorithms for computing phylogenetic biodiversity. Algorithms in Bioinformatics, LNCS 8701: 187-203.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | #Load phylogenetic tree of bird families from package "ape"
data(bird.families, package = "ape")
#Create 100 random communities with 50 families each
comm = matrix(0,nrow = 100,ncol = length(bird.families$tip.label))
for(i in 1:nrow(comm)) {comm[i,sample(1:ncol(comm),50)] = 1}
colnames(comm) = bird.families$tip.label
chi=0.6
#Calculate p-values under the uniform model
cac.pvalues(bird.families,comm,chi, reps=1000)
# Create random abundance weights
weights = runif(length(bird.families$tip.label))
names(weights) = bird.families$tip.label
# Calculate p-values under the sequential model
cac.pvalues(bird.families,comm,chi,null.model="sequential",
abundance.weights=weights, reps=1000)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.