rao.diversity: Rao's quadratic entropy

Description Usage Arguments Details Value Note Author(s) References See Also Examples

Description

Calculates Rao's quadratic entropy, functional and phylogenetic redundancy.

Usage

1
2
rao.diversity(comm, traits = NULL, phylodist = NULL, checkdata = TRUE,
  ord = "metric", put.together = NULL, standardize = TRUE, ...)

Arguments

comm

Community data, with species as columns and sampling units as rows. This matrix can contain either presence/absence or abundance data.

traits

Data frame or matrix data of species described by traits, with traits as columns and species as rows (Default traits = NULL).

phylodist

Matrix containing phylogenetic distance between species (Default phylodist = NULL).

checkdata

Logical argument (TRUE or FALSE) to check if species sequence in the community data follows the same order as the one in the trait and in the phylodist matrices (Default checkdata = TRUE).

ord

Method to be used for ordinal variables, see gowdis (Default ord = "metric").

put.together

List to specify group of traits. Each group specify receive the same weight that one trait outside any group, in the way each group is considered as unique trait (Default put.together = NULL). This argument must be a list, see examples in syncsa.

standardize

Logical argument (TRUE or FALSE) to specify if standardize phylogenetic distance to range into range 0 to 1. (Default standardize = TRUE).

...

Parameters for gowdis function.

Details

Rao's quadratic entropy is a measure of diversity of ecological communities defined by Rao (1982) and is based on the proportion of the abundance of species present in a community and some measure of dissimilarity among them. The dissimilarity range from 0 to 1 and is based on a set of specified functional traits or in the phylogenetic dissimilarity.

For the trait data, the function calculates the square root of the one-complement of Gower's similarity index, in order to have a dissimilarity matrix with Euclidean metric properties. Gower's index ranges from 0 to 1 and can handle traits measured indifferent scales. When the species are completely different in terms of their traits, Rao quadratic entropy is equivalent to the Gini-Simpson index. Traits data can be numeric, factor or ordered factor. For this be considered traits data must be of data.frame class and containing each variable type determined. For additional details and requirements of function please see gowdis.

Functional redundancy is defined purely as the difference between species diversity and Rao's quadratic entropy based on their functional dissimilarity (de Bello et al. 2007). The same definition is used for phylogenetic redundancy.

Value

Simpson

Gini-Simpson index within each community (equivalent to Rao quadratic entropy with null, crisp, similarities).

FunRao

Rao quadratic entropy within each community, considering trait distance.

FunRedundancy

Functional redundancy in each community.

PhyRao

Rao quadratic entropy within each community, considering phylogenetic distance.

PhyRedundancy

Phylogenetic redundancy in each community.

Note

IMPORTANT: The sequence species show up in community data matrix MUST be the same as they show up in traits and phylodist matrices. See organize.syncsa.

Author(s)

Vanderlei Julio Debastiani <[email protected]>

References

de Bello, F.; Leps, J.; Lavorel, S. & Moretti, M. (2007). Importance of species abundance for assessment of trait composition: an example based on pollinator communities. Community Ecology, 8, 163:170.

Pillar, V.D.; Blanco, C.C.; Muler, S.C.; Sosinski, E.E.; Joner, F. & Duarte, L.d.S. (2013). Functional redundancy and stability in plant communities. Journal of Vegetation Science, 24, 963:974.

Rao, C.R. (1982). Diversity and dissimilarity coefficients: a unified approach. Theoretical Population Biology, 21, 24:43.

See Also

organize.syncsa, gowdis, syncsa

Examples

1
2
3
data(ADRS)
rao.diversity(ADRS$community)
rao.diversity(ADRS$community, traits = ADRS$traits)

Example output

$call
rao.diversity(comm = ADRS$community)

$Simpson
   Site_1    Site_2    Site_3    Site_4    Site_5    Site_6    Site_7    Site_8 
0.4444444 0.4444444 0.2448980 0.6493056 0.6975000 0.7032136 0.7376726 0.7148760 
   Site_9   Site_10 
0.7376726 0.6712018 

$call
rao.diversity(comm = ADRS$community, traits = ADRS$traits)

$Simpson
   Site_1    Site_2    Site_3    Site_4    Site_5    Site_6    Site_7    Site_8 
0.4444444 0.4444444 0.2448980 0.6493056 0.6975000 0.7032136 0.7376726 0.7148760 
   Site_9   Site_10 
0.7376726 0.6712018 

$FunRao
   Site_1    Site_2    Site_3    Site_4    Site_5    Site_6    Site_7    Site_8 
0.1795441 0.2862875 0.1751897 0.3862305 0.3285702 0.4327291 0.3543901 0.4596138 
   Site_9   Site_10 
0.3608239 0.4605144 

$FunRedundancy
    Site_1     Site_2     Site_3     Site_4     Site_5     Site_6     Site_7 
0.26490032 0.15815699 0.06970824 0.26307501 0.36892982 0.27048447 0.38328252 
    Site_8     Site_9    Site_10 
0.25526226 0.37684872 0.21068740 

SYNCSA documentation built on May 2, 2019, 9:38 a.m.