auc.ppm: Area Under ROC Curve

In spatstat.model: Parametric Statistical Modelling and Inference for the 'spatstat' Family

Area Under ROC Curve

Description

Compute the AUC (area under the Receiver Operating Characteristic curve) for a fitted point process model.

Usage

## S3 method for class 'ppm'
auc(X, ..., subset=NULL)

## S3 method for class 'kppm'
auc(X, ..., subset=NULL)

## S3 method for class 'slrm'
auc(X, ..., subset=NULL)

Arguments

X	Fitted point process model (object of class "ppm" or "kppm" or "lppm") or fitted spatial logistic regression model (object of class "slrm").
...	Arguments passed to roc.ppm, and arguments passed to as.mask controlling the pixel resolution for calculations,
subset	Optional. A spatial window (object of class "owin") specifying a subset of the data, for which the AUC should be calculated.

Details

This command computes the AUC, the area under the Receiver Operating Characteristic curve. The ROC itself is computed by roc.

For a fitted point process model X, the AUC measures the ability of the fitted model intensity to separate the spatial domain into areas of high and low density of points. Suppose \lambda(u) is the intensity function of the model. The AUC is the probability that \lambda(x_i) > \lambda(U). That is, AUC is the probability that a randomly-selected data point has higher predicted intensity than does a randomly-selected spatial location. The AUC is not a measure of the goodness-of-fit of the model (Lobo et al, 2007).

(For spatial logistic regression models (class "slrm") replace “intensity” by “probability of presence” in the text above.)

The algorithm also calculates the theoretically expected AUC value for this model, as described in \rocpapercite.

Value

Numeric vector of length 2 giving the AUC value and the theoretically expected AUC value for this model.

Author(s)

\rocketAuthors

.

References

\rocpaper

.

Lobo, J.M., Jimenez-Valverde, A. and Real, R. (2007) AUC: a misleading measure of the performance of predictive distribution models. Global Ecology and Biogeography 17(2) 145–151.

Nam, B.-H. and D'Agostino, R. (2002) Discrimination index, the area under the ROC curve. Pages 267–279 in Huber-Carol, C., Balakrishnan, N., Nikulin, M.S. and Mesbah, M., Goodness-of-fit tests and model validity, Birkhauser, Basel.

See Also

roc, roc.ppm, youden.

Examples

  fit <- ppm(swedishpines ~ x+y)
  auc(fit)
  auc(swedishpines, "x")

spatstat.model documentation built on Nov. 5, 2025, 5:39 p.m.