Truncate suitability predictions based on an extrapolation value

Exclusion of suitability predictions in environmental conditions assumed to be extrapolative.

Usage

extra_truncate(suit, extra, threshold = 50, trunc_value = 0)

Arguments

suit

SpatRaster with suitability values

extra

SpatRaster with extrapolation values preferable measured with extra_eval function

threshold

numeric. Vector with one or more extrapolation values used for truncate suitability Default 50%

trunc_value

numeric. Numeric value to be used to those cells assumed to be extrapolative

Value

A SpatRaster object with truncated suitability values

Details

Exclusion of suitability predictions in environmental conditions assumed to be extrapolative. In this function it is possible to use any metric measuring degree of extrapolation (e.g., MESS-Multivariate Environmental Similarity Surfaces, EO-Environmental Overlap, MOP-Mobility-Oriented Parity, EXDET-Extrapolation Detection, or AOA-Area of Applicability). However, we recommend to use Shape approach (see extra_eval, and Velazco et al., 2023).

This function truncates suitability predictions assigning a given value, generally 0 or NA. Usage trunc_value = NA. Default 0.

To those cells assumed to be extrapolative, i.e., higher than a given threshold of a given extrapolation metric.

See this vignette at flexsdm website for further details about Shape metric, model truncation, and tools to explore model extrapolation.

See also

extra_eval, p_extra, p_pdp, p_bpdp

Examples

if (FALSE) {
# see examples in extra_eval function
}