sim.het {simba} | R Documentation |
Useful for systematic sampling grids for calculating the mean similarity and its standard deviation between a focal unit and its surrounding units. Surrounding can be specified by the user.
sim.het(mat, coord=NULL, dn, method="soerensen", test=TRUE, permutations=100, ...) het2nbs(mat, coord=NULL, dn, method="soerensen", ...)
mat |
Species matrix or dist object resulting from similarity calculation. |
coord |
A data.frame with two columns containing the coordinates of the plots for which species data or a dist matrix is given. Defaults to NULL. Then, mean similarity and standard deviation of similarities from each plot to all other plots is calculated |
dn |
A numeric or a two value vector. In the first case it gives the distance until which sampling units should be considered as neighbors. In the second the two values define a ring around each plot. Plots which fall into the ring are considered as neighbors. Not necessary and skipped when coord =NULL |
method |
Only necessary when a species matrix is given. Specifies the method for calculating the similarity between plots with sim . For more details see the documentation of sim . |
test |
Shall significance be calculated? Defaults to TRUE which means that it is tested if the observed pattern is significantly different from random |
permutations |
Number of permutations for the significance test. Species are permuted on plots and the index is recalculated for each permuted species matrix. The initial values are then tested against the permuted values to obtain a significance level. |
... |
Further arguments passed to sim . |
If similarities (e.g. of species composition) are calculated between plots in a regular or irregular array (whereas the latter might be problematic because of spatial auto-correlation) the resulting values have no position. However they could be associated to a point in the centre between the compared plots (for each compared pair). Sometimes it is wanted to associate a dissimilarity value to the focal unit which comprises the similarities/dissimilarities of a focal unit to all surrounding units. One possibility is the calculation of a mean similarity (Williams 1996, Lennon 2001, Gaston 2001) out of the single similarities between a focal unit and its surrounding units. This might be problematic as the single similarity values might result from different sets of species. To include the variability of the single similarities between a focal unit and its neighbours as a measure of spatial heterogeneity the variation (sd) in the similarity values is included. See sim.pat
for the calculation of similarity between a focal unit and its neighbours whilst preserving species identity.
Significance is tested against random expectations with a permutation procedure. After calculating the values for mean
and sd
the species/similarity matrix is permuted and the values are calculated again. This is done permutation
times. Then the initial values are tested against the obtained distribution. If the initial values are under the mean of the respective values among plots they are tested against the lower tail of the permuted distribution. If they exceed the mean, they are tested against the upper tail of the permuted distribution. If a value is significant, this means that it is signifcantly different from a random distribution of species and therefore might likely be caused by underlying envrionmental patterns.
A data.frame
with the following columns
nnbs |
Number of neighbours of the respective plot. Results from the neighbour definition dn . |
m.sims |
Mean similarity between plot and its neighbours. |
sd.sims |
Standard deviation of the similarity values calculated between the plot and its neighbours. |
sim.test.mean |
The p-value of the significance test for the mean -values. |
sig.mean |
The significance decision tested against alpha = 0.05. "*" indicates, that mean value is significantly different from random. |
sig.prefix.mean |
Marks against which tail significance of mean was tested. If the initial similarity value is lower than the mean of the permuted values the lower tail is tested (sig.prefix = "-" ) and vice versa (sig.prefix = "+" ). |
sim.test.sd |
The p-value of the significance test for the sd -values. |
sig.sd |
The significance decision tested against alpha = 0.05. "*" indicates, that sd value is significantly different from random. |
sig.prefix.sd |
Marks against which tail significance of sd was tested. If the initial similarity value is lower than the mean of the permuted values the lower tail is tested (sig.prefix = "-" ) and vice versa (sig.prefix = "+" ). |
Gerald Jurasinski terhorab@mac.com; Vroni Retzer vroni.retzer@uni.bayreuth.de
Gaston, K. J., Rodrigues, A. S. L., van Rensburg, B. J., Koleff, P. & Chown, S. L. (2001) Complementary representation and zones of ecological transition. Ecology Letters 4: 4-9.
Jurasinski, G. & Retzer, V. in prep. Measuring multi-plot similarity with presence-absence data. Ecology
Lennon, J. J., Koleff, P., Greenwood, J. J. D. & Gaston, K. J. (2001) The geographical structure of British bird distributions: diversity, spatial turnover and scale. Journal of Animal Ecology 70: 966-979.
Williams, P. H. (1996) Mapping variations in the strength and breadth of biogeographic transition zones using species turnover. Proceedings of the Royal Society of London Series B-Biological Sciences 263: 579-588.
data(abis) ## calculate average similarity for the focal plots abis.het <- sim.het(abis.spec, coord=abis.env[,1:2], dn=100)