aucGARP: Area Under the Receiver Operating Characteristic (ROC) curve...

Description Usage Arguments Details Value References See Also Examples

View source: R/aucGARP.R

Description

aucGARP Calculates the area under the ROC curve (AUC), which represents the accuracy of the subset of the best models produced by GARP. AUC evaluates the predictive performance of the best models by relating the model sensitivity (true positive rate) to 1-specificity (true negative rate), and can be described as the probability that any given cell is correctly predicted as present or absent. An AUC of 0.5 is that predicted at random, while an AUC of 1 represents a perfect prediction

Usage

1
aucGARP(n, x, points)

Arguments

n

a numeric value specifying the number of models in the best subset outputted by DesktopGARP

x

a raster object of the summated raster of the best models output by DesktopGARP

points

a spatial object of presence data to use for testing locations

Details

When calculating AUC for discrete cutpoints (n), represented by the number of models that agree on a predicted presence location, the AUC of the entire curve is essentially equal to the Wilcoxon test statistic. The raster object (x) should be a raster representing the number of models that agree on a predicted presence location per pixel and that outtput by sumRasters. The shapefile points should presence locations that were not used by GARP for model training and those output by splitData.

Value

Plots the Receiver Operating Characteristic (ROC) curve and returns a list containing:

References

Cortes, C. and Mohri, M. (2004) Confidence Intervals for the Area Under the ROC curve. Advances in Neural Information Processing Systems. 6.

See Also

zAUC, seAUC, wGARP, plotROC

Examples

1
2
3
4
5
6
  set.seed(0)
  library(raster)
  r   <- raster(ncols = 100, nrows = 100)
  r[] <- rbinom(5, 10, 0.3)
  hs  <- data.frame("Latitude" = c(-89, 72, 63, 42, 54), "Longitude" = c(-12, 13, 24, 26, 87), "Species" = rep("Homo_sapiens", 5))
  aucGARP(n = 10, x = r, points = SpatialPoints(hs[,1:2]))

cghaase/GARPTools documentation built on Aug. 6, 2021, 6:38 a.m.