Co-Occurrence

Co-Occurrence

Usage

occurrence(object, ...)

# S4 method for class 'matrix'
occurrence(object, method = c("absolute", "relative", "binomial"))

# S4 method for class 'data.frame'
occurrence(object, method = c("absolute", "relative", "binomial"))

Arguments

object

A \(m \times p\) numeric matrix or data.frame of count data (absolute frequencies giving the number of individuals for each category, i.e. a contingency table). A data.frame will be coerced to a numeric matrix via data.matrix().

...

Currently not used.

method

A character string specifying the method to be used. It must be one of "absolute", "relative" or "binomial" (see details). Any unambiguous substring can be given.

Value

A stats::dist object.

Details

absolute

Count how many times each pairs of types occur together in at least one sample (absolute frequencies).

relative

Count how many times each pairs of types occur together in at least one sample (relative frequencies).

binomial

Binomial co-occurrence assessment.

See also

Other diversity measures: diversity(), evenness(), heterogeneity(), plot.DiversityIndex(), plot.RarefactionIndex(), profiles(), rarefaction(), richness(), she(), similarity(), simulate(), turnover()

Author

N. Frerebeau

Examples

## Data from Conkey 1980, Kintigh 1989
data("cantabria")

## Plot spot diagram of a co-occurrence matrix
occ_abs <- occurrence(cantabria, method = "absolute") # Absolute frequencies
plot_spot(occ_abs)


occ_rel <- occurrence(cantabria, method = "relative") # Relative frequencies
plot_spot(occ_rel)


## Binomial co-occurrence (similarity between types)
occ_bin <- occurrence(cantabria, method = "binomial")
plot_spot(occ_bin)