Last data update: 2014.03.03

R: Indicator Species Analysis by Murdoch Preference Function
murdochR Documentation

Indicator Species Analysis by Murdoch Preference Function

Description

Calculates the indicator value of species in a single cluster or environment type using the Murdoch Preference Function

Usage

murdoch(taxa,type,minval=0,minplt=10)
## S3 method for class 'murdoch'
summary(object,pval=0.05,ndigits=3,...)
## S3 method for class 'murdoch'
plot(x,axtype=1,pval=0.05,...)

Arguments

taxa

a matrix or data.frame of samples with species as columns and samples as rows

type

a logical vector with values of TRUE for samples in a specific cluster or type

minval

a threshold minimum abundance value to count as a presence

minplt

the minimum number of presences to include a species in the calculation

object

and object of class ‘murdoch’

pval

the maximum probability to include a species in the summary table

ndigits

the number of digits to report

...

ancillary arguments to maintain compatibility with the generic summary function

x

an object of class ‘murdoch’

axtype

a switch to control scaling of the x axis in the plot. 1=number of plots in the data set, other = number of presences in the type

Details

Calculates the indicator value of species for a specific type using the modified Murdoch statistic:

log((p/a) * (n-p_i)/n_i)

where: p = number of samples where species is present, a = number of samples where species is absent, n = total number of samples (p+a), p_i = number of samples in type i where species is present, n_i = number of samples in type i.

Probabilities are based on the hypergeometric distribution calculation of having as many or more presences in a type as observed.

Value

a list object of class ‘murdoch’ with components:

minplt

the minimum number of presences to be included

nplots

the number of plots a species occurs in

type

the plot membership vector for the type

pres

the number of presences for species in the type

abs

the number of absences of species in the type

murdoch

the Murdoch value for species in the type

pval

the probability of getting such a high murdoch value

Note

Indicator value analysis is a set of techniques designed to identify species of special interest in clusters or types. The most widely used indicator species analysis was proposed by Dufrene and Legendre (1997), and is included in package ‘labdsv’ as indval. murdoch differs significantly from indval in assumption and objective, seeking to identify species that have improbable occurrences in types, regardless of their relative frequency in the type

Author(s)

David W. Roberts with help from Ken Aho droberts@montana.edu http://ecology.msu.montana.edu/labdsv/R

See Also

indval, tabdev

Examples

    data(shoshveg) # returns a vegetation dataframe
    dis.bc <- dsvdis(shoshveg,'bray/curtis') # returns a dissimilarity matrix
    clust <- optpart(5,dis.bc)
    murdoch(shoshveg,clust$clustering==1)

Results