hyper.quality: Quality of hyperspace.

In BAT: Biodiversity Assessment Tools

Quality of hyperspace.

Description

Assess the quality of a functional hyperspace.

Usage

hyper.quality(distance, trait)

Arguments

distance	A dist object representing the initial distances between species.
trait	A trait matrix, often resulting from 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)

trait = hyper.build(distance, axes = 0.9)
hyper.quality(distance, trait)

BAT documentation built on Aug. 8, 2025, 6:35 p.m.