Design your own Dissimilarities
You can define your own dissimilarities using terms for shared and total quantities, number of rows and number of columns. The shared and total quantities can be binary, quadratic or minimum terms. In binary terms, the shared component is number of shared species, and totals are numbers of species on sites. The quadratic terms are cross-products and sums of squares, and minimum terms are sums of parallel minima and row totals.
1 2 3
Equation for your dissimilarities. This can use terms
How shared and total components are found. For vectors
Use 2x2 contingency table notation for binary data: a is the number of shared species, b and c are the numbers of species occurring only one of the sites but not in both, and d is the number of species that occur on neither of the sites.
Use beta diversity notation with terms
The name you want to use for your index. The default is to
Most popular dissimilarity measures in ecology can be expressed with
the help of terms
B, and some also involve
P. Some examples you can define in
|| ||squared Euclidean|
|| ||(dis)similarity ratio|
|| ||cosine complement|
|| || Raup-Crick (but see
designdist can implement most dissimilarity
vegdist or elsewhere, and it can also be
used to implement many other indices, amongst them, most of those
described in Legendre & Legendre (2012). It can also be used to
implement all indices of beta diversity described in Koleff et
al. (2003), but there also is a specific function
betadiver for the purpose.
If you want to implement binary dissimilarities based on the 2x2
contingency table notation, you can set
abcd = TRUE. In this
a = J,
b = A-J,
c = B-J,
d = P-A-B+J.
This notation is often used instead of the more more
tangible default notation for reasons that are opaque to me.
alphagamma = TRUE it is possible to use beta diversity
notation with terms
alpha for average alpha diversity and
gamma for gamma diversity in two compared sites. The terms
are calculated as
alpha = (A+B)/2,
gamma = A+B-J and
delta = abs(A-B)/2. Terms
B are also
available and give the alpha diversities of the individual compared
sites. The beta diversity terms may make sense only for binary
terms (so that diversities are expressed in numbers of species), but
they are calculated for quadratic and minimum terms as well (with a
designdist returns an object of class
designdist does not use compiled code, and may be slow or use
plenty of memory in large data sets. It is very easy to make errors
when defining a function by hand. If an index is available in a
function using compiled code, it is better to use the canned
Koleff, P., Gaston, K.J. and Lennon, J.J. (2003) Measuring beta diversity for presence–absence data. J. Animal Ecol. 72, 367–382.
Legendre, P. and Legendre, L. (2012) Numerical Ecology. 3rd English ed. Elsevier
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
data(BCI) ## Four ways of calculating the same Sørensen dissimilarity d0 <- vegdist(BCI, "bray", binary = TRUE) d1 <- designdist(BCI, "(A+B-2*J)/(A+B)") d2 <- designdist(BCI, "(b+c)/(2*a+b+c)", abcd = TRUE) d3 <- designdist(BCI, "gamma/alpha - 1", alphagamma = TRUE) ## Arrhenius dissimilarity: the value of z in the species-area model ## S = c*A^z when combining two sites of equal areas, where S is the ## number of species, A is the area, and c and z are model parameters. ## The A below is not the area (which cancels out), but number of ## species in one of the sites, as defined in designdist(). dis <- designdist(BCI, "(log(A+B-J)-log(A+B)+log(2))/log(2)") ## This can be used in clustering or ordination... ordiplot(cmdscale(dis)) ## ... or in analysing beta diversity (without gradients) summary(dis)
Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.