ses.mnnd {picante}R Documentation

Standardized effect size of MNND

Description

Standardized effect size of mean nearest neighbour distances in communities. When used with a phylogenetic distance matrix, equivalent to -1 times the Nearest Taxon Index (NTI).

Usage

ses.mnnd(samp, dis, null.model = c("taxa.labels","sample.pool", "phylogeny.pool",
            "independentswap", "trialswap"), runs = 999, iterations = 1000)    

Arguments

samp Community data matrix
dis Distance matrix (generally a phylogenetic distance matrix)
null.model Null model to use
taxa.labels
Shuffle distance matrix labels (across all taxa included in distance matrix)
sample.pool
Randomize community data matrix by drawing species from pool of species occurring in at least one community (sample pool) with equal probability
phylogeny.pool
Randomize community data matrix by drawing species from pool of species occurring in the distance matrix (phylogeny pool) with equal probability
frequency
Randomize community data matrix abundances within species (maintains species occurence frequency)
richness
Randomize community data matrix abundances within samples (maintains sample species richness)
independentswap
Randomize community data matrix with the independent swap algorithm (Gotelli 2000) maintaining species occurrence frequency and sample species richness
trialswap
Randomize community data matrix with the trial-swap algorithm (Miklos & Podani 2004) maintaining species occurrence frequency and sample species richness
runs Number of randomizations
iterations Number of iterations to use for each randomization (for independent swap and trial null models)

Value

A data frame of results for each community

ntaxa Number of taxa in community
mpd.obs Observed MNND in community
mpd.rand.mean Mean MNND in null communities
mpd.rand.sd Standard deviation of MNND in null communities
mpd.obs.rank Rank of observed MNND vs. null communities
mpd.obs.z Standardized effect size of MNND vs. null communities (= (mpd.obs - mpd.rand.mean) / mpd.rand.sd, equivalent to -NTI)
mpd.obs.p P-value (quantile) of observed MNND vs. null communities (= mpd.obs.rank / runs + 1)
runs Number of randomizations

Author(s)

Steve Kembel <skembel@berkeley.edu>

References

Webb, C.O., Ackerly, D.D., and Kembel, S.W. 2008. Phylocom: software for the analysis of phylogenetic community structure and trait evolution. Version 4.0.1. http://www.phylodiversity.net/phylocom/.

See Also

mnnd, randomizeSample

Examples

data(phylocom)
ses.mnnd(phylocom$sample, cophenetic(phylocom$phylo),null.model="taxa.labels")

[Package picante version 0.4-0 Index]