show.detsurf: Plotting the detection probability surface

View source: R/surveyplots.r

show.detsurfR Documentation

Plotting the detection probability surface

Description

Plots the detection probability surface, based on trap locations and the estimated detection function from a model fitted using fit.ascr.

Usage

show.detsurf(
  fit,
  session = 1,
  surface = TRUE,
  mask = NULL,
  col = "black",
  levels = NULL,
  xlim = NULL,
  ylim = NULL,
  show.labels = TRUE,
  trap.col = "red",
  add = FALSE,
  ...
)

Arguments

fit

A fitted model from fit.ascr.

session

For multisession models, the session from which the plot should be generated.

surface

Logical, if TRUE a 3D detection surface is plotted over the mask point locations, otherwise a contour plot is shown.

mask

A matrix with two columns. Each row provides Cartesian coordinates for the location of a mask point. The function create.mask will return a suitable object. The mask used to fit the model fit will be used by default; this argument is usually used when estimated location contours need to be plotted to a higher resolution than this.

col

The colour of the plotted contours.

levels

A numeric vector giving the values to be associated with the plotted contours. Alternatively, this can be the character string "esa", which results in a contour encapsulating an area equal to the estimated effective sampling area.

xlim

A numeric vector of length 2, giving the x coordinate range.

ylim

A numeric vector of length 2, giving the y coordinate range.

show.labels

Logical, if TRUE, contours are labelled with the appropriate probability.

trap.col

The colour of the points representing detector locations.

add

Logical, if TRUE, contours will be added to an existing plot.

...

Arguments to be passed to persp.

Examples

show.detsurf(example.data$fits$simple.hn)


b-steve/ascr documentation built on Aug. 15, 2022, 2:38 p.m.