rescale.regular {zetadiv} | R Documentation |
Rescaling of data following a hierarchical increase in grain size
Description
Increases grain by hierarchically nesting regularly spaced sites.
Usage
rescale.regular(xy, data.spec, data.env = NULL, method = "mean", n)
Arguments
xy |
Site-by-coordinate data frame, with sites as rows and coordinates as columns. |
data.spec |
Site-by-species presence-absence data frame, with sites as rows and species as columns. |
data.env |
Site-by-variable data frame, with sites as rows and environmental variables as columns. |
method |
Name of a function (as a string) indicating how to combine the coordinates and the environmental variables. It can be a basic R-function such as " |
n |
Mapping grain (the number of sites combined to generate data at a coarser grain). Regularly spaced sites are grouped as |
Details
The sites (plots or quadrates) are aggregated as nearest neighbouring groups of n
x n
sites, using a nested approach, starting from the lowest x and y, to increase the grain. The sites can be spatially contiguous or discontiguous, as long as they are regularly spaced. This function is not suitable for irregularly spaced sites. If the total number of sites is not a multiple of n
x n
, the extra sites are discarded.
Value
rescale.regular
returns a data frame with the rescaled data.
References
Hui C. & McGeoch M.A. (2014). Zeta diversity as a concept and metric that unifies incidence-based biodiversity patterns. The American Naturalist, 184, 684-694.
Scheiner S.M., Chiarucci A., Fox G.A., Helmus M.R., McGlinn D.J. & Willig M.R. (2011). The underpinnings of the relationship of species richness with space and time. Ecological Monographs, 81, 195-213.
See Also
Zeta.decline.mc
, Zeta.order.mc
, Zeta.decline.ex
, Zeta.order.ex
, Zeta.scale.regular
, Zeta.scale.min.dist
, rescale.min.dist
Examples
utils::data(bird.spec.fine)
xy.bird <- bird.spec.fine[1:2]
data.spec.bird <- bird.spec.fine[3:192]
data.rescale <- rescale.regular(xy.bird, data.spec.bird, n = 4)