SDMeval: Evaluate species distribution models

View source: R/SDMeval.R

SDMevalR Documentation

Evaluate species distribution models

Description

Performs model evaluation. Measure of AUC (Area Under the Curve) value, confusion matrix, maxSSS threshold (Maximum Sensitivity plus Specificity), percentage of predicted preferential area based on the MaxSSS value and model stability (standard deviation of pixel values)

Usage

SDMeval(model)

Arguments

model

Model produced with compute.maxent or compute.brt functions

Details

Area Under the Curve is a parameter largely refered in the literature and used to test species distribution models performance (Fielding & Bell, 1997). It evaluates the area under the Receiver Operating Curve (ROC), which draws the relationship between 1-specificity (False Positive Rate) and specificity (True Positive Rate). AUC values bordering 1 present models with high True Positive Rate, 0.5 model with random prediction and 0 to models presenting a strong False Positive Rate.

MaxSSS threshold value maximizes the sum of True Positive Rate and True Negative Rate. See Liu et al. (2013) for more information.

Modelling performance can be evaluated with the measure of omission rate, the proportion of occurrences that falls out the area predicted as preferential by the MaxSSS threshold (False Positive Rate). Models stability is evaluated with the mean standard deviation value of the pixel values of the grid predicted by the model.

Value

Dataframe with the following information

  • AUC.value Returns the AUC (Area Under the Curve) value of the model

  • maxSSS Maximum Sensitivity plus Sensibility threshold of the model

  • preferential.area Pixel proportion for which the predicted value is superior to the MaxSSS threshold

  • omission.rate Proportion of data that fall out of the area predicted as preferential

  • nb.omission Corresponding number of data that fall out of the predicted preferential area

  • SD.value Mean standard deviation of the predicted grid

References

Fielding A, & J Bell (1997) A review of methods for the assessment of prediction errors in conservation presence absence models. Environmental Conservation, 24(1): 38-49.

Liu C, M White & G Newell (2013) Selecting thresholds for the prediction of species occurrence with presence only data. Journal of Biogeography, 40(4): 778-789.

Examples

#Generate a SDMtab and launch a model
data('ctenocidaris.nutrix')
occ <- ctenocidaris.nutrix
occ <- ctenocidaris.nutrix[,c('decimal.Longitude','decimal.Latitude')]

data(predictors2005_2012)
envi <- predictors2005_2012
envi

SDMtable_ctenocidaris <- SDMPlay:::SDMtab(xydata=occ,
                                         predictors=predictors2005_2012,
                                         unique.data=FALSE,
                                         same=TRUE)
model <- SDMPlay:::compute.brt(x=SDMtable_ctenocidaris, proj.predictors=envi,lr=0.005)

# Evaluate modelling performance
SDMPlay:::SDMeval(model)

charleneguillaumot/SDMPlay documentation built on Feb. 2, 2023, 1:09 p.m.