| hyper.quality {BAT} | R Documentation |
Quality of hyperspace.
Description
Assess the quality of a functional hyperspace.
Usage
hyper.quality(distance, hyper)
Arguments
distance |
A dist object representing the initial distances between species. |
hyper |
A matrix with coordinates data from function hyper.build. |
Details
This is used for any representation using hyperspaces, including convex hull and kernel-density hypervolumes. The algorithm calculates the inverse of the squared deviation between initial and euclidean distances (Maire et al. 2015) after standardization of all values between 0 and 1 for simplicity of interpretation. A value of 1 corresponds to maximum quality of the functional representation. A value of 0 corresponds to the expected value for an hyperspace where all distances between species are 1.
Value
A single value of quality.
References
Maire et al. (2015) How many dimensions are needed to accurately assess functional diversity? A pragmatic approach for assessing the quality of functional spaces. Global Ecology and Biogeography, 24: 728:740.
Examples
trait = data.frame(body = c(1,2,3,4,4), beak = c(1,1,1,1,2))
distance = gower(trait)
hyper = hyper.build(trait, axes = 2)
hyper.quality(distance, hyper)
hyper = hyper.build(trait, axes = 0)
hyper.quality(distance, hyper)