extra_truncate: Truncate suitability predictions based on an extrapolation...

In sjevelazco/flexsdm: Tools for Data Preparation, Fitting, Prediction, Evaluation, and Post-Processing of Species Distribution Models

Truncate suitability predictions based on an extrapolation value

Description

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

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.

Value

A SpatRaster object with truncated suitability values

See Also

extra_eval, p_extra, p_pdp, p_bpdp

Examples

## Not run: 
# see examples in extra_eval function

## End(Not run)

sjevelazco/flexsdm documentation built on Feb. 28, 2025, 9:07 a.m.