tabula (version 3.2.0)

occurrence: Co-Occurrence

Description

Co-Occurrence

Usage

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

Value

A stats::dist object.

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.

Author

N. Frerebeau

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: heterogeneity(), plot_diversity, plot_rarefaction, profiles(), rarefaction(), richness(), she(), similarity(), simulate(), turnover()

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)