ecospat.niche.similarity.test

0th

Percentile

Niche Similarity Test

Run a niche similarity test (see Warren et al 2008) based on two species occurrence density grids.

Usage
ecospat.niche.similarity.test (z1, z2, rep, alternative = "greater", 
rand.type = 1, ncores= 1)
Arguments
z1

Species 1 occurrence density grid created by ecospat.grid.clim.

z2

Species 2 occurrence density grid created by ecospat.grid.clim.

rep

The number of replications to perform.

alternative

To indicate the type of test to be performed. It could be greater or lower.

rand.type

Type of randomization on the density grids (1 or 2).

ncores

The number of cores used for parallelisation.

Details

Compares the observed niche overlap between z1 and z2 to overlaps between z1 and random niches (z2.sim) as available in the range of z2 (z2$Z). z2.sim has the same pattern as z2 but the center is randomly translatated in the availabe z2$Z space and weighted by z2$Z densities. If rand.type = 1, both z1 and z2 are randomly shifted, if rand.type =2, only z2 is randomly shifted.

alternative specifies if you want to test for niche conservatism (alternative = "greater", i.e. the niche overlap is more equivalent/similar than random) or for niche divergence (alternative = "lower", i.e. the niche overlap is less equivalent/similar than random).

If you encounter a problem during your analyses, please first read the FAQ section of "Niche overlap" in http://www.unil.ch/ecospat/home/menuguid/ecospat-resources/tools.html

The arguments ncores allows choosing the number of cores used to parallelize the computation. The default value is 1. On multicore computers, the optimal would be ncores = detectCores() - 1.

Value

a list with $obs = observed overlaps, $sim = simulated overlaps, $p.D = p-value of the test on D, $p.I = p-value of the test on I.

References

Broennimann, O., M.C. Fitzpatrick, P.B. Pearman, B. Petitpierre, L. Pellissier, N.G. Yoccoz, W. Thuiller, M.J. Fortin, C. Randin, N.E. Zimmermann, C.H. Graham and A. Guisan. 2012. Measuring ecological niche overlap from occurrence and spatial environmental data. Global Ecology and Biogeography, 21, 481-497.

Warren, D.L., R.E. Glor and M. Turelli. 2008. Environmental niche equivalency versus conservatism: quantitative approaches to niche evolution. Evolution, 62, 2868-2883.

See Also

ecospat.grid.clim.dyn, ecospat.niche.equivalency.test

Aliases
  • ecospat.niche.similarity.test
Documentation reproduced from package ecospat, version 3.0, License: GPL

Community examples

Looks like there are no examples yet.