Learn R Programming

phyloregion (version 2.1.0)

tpd_beta_core: Functional beta diversity using trait probability densities

Description

tpd_beta_core computes efficiently for large community matrices the overlap between the trait probability densities (TPD) of pairs of grid cells, and splits the non-overlapping part into the part in trait space used by only one grid cell (unique) and the part in trait space used by both (nested).

Usage

tpd_beta_core(x, trait, ...)

tpd_beta(x, trait, ...)

Value

tpd_beta_core returns an object of class "tpd.betapart", a list of dist objects: shared (overlap), not.shared

(1 - overlap), unique.i, unique.j, nested.i and nested.j.

tpd_beta returns a list with three dissimilarity matrices:

  • beta.unique dissimilarity due to trait space occupied by only one of the grid cells (turnover-like)

  • beta.nested dissimilarity due to different densities in trait space shared by both grid cells (nestedness-like)

  • beta.total total dissimilarity, 1 - overlap

Arguments

x

an object of class Matrix or matrix, where rows are grid cells and columns are species.

trait

A data frame with the first column labeled “species” and the remaining columns containing continuous and/or categorical traits.

...

Further arguments passed to the internal TPD builder, see tpd_alpha.

References

Carmona, C.P., de Bello, F., Mason, N.W.H. & Leps, J. (2016) Traits without borders: integrating functional diversity across scales. Trends in Ecology & Evolution 31: 382--394.

See Also

tpd_alpha, phylobeta, beta_diss

Examples

Run this code
data(africa)
tr <- data.frame(species = africa$trait$species,
                 height = log10(africa$trait$h_max),
                 habit = africa$trait$habit)
tbc <- tpd_beta_core(africa$comm, tr)
tb <- tpd_beta(africa$comm, tr)

Run the code above in your browser using DataLab