homerange: Home Range Statistics

Description Usage Arguments Details Value Note References See Also Examples

Description

Some ad hoc measures of home range size may be calculated in secr from capture–recapture data:

dbar is the mean distance between consecutive capture locations, pooled over individuals (e.g. Efford 2004). moves returns the raw distances.

MMDM (for ‘Mean Maximum Distance Moved’) is the average maximum distance between detections of each individual i.e. the observed range length averaged over individuals (Otis et al. 1978).

ARL (or ‘Asymptotic Range Length’) is obtained by fitting an exponential curve to the scatter of observed individual range length vs the number of detections of each individual (Jett and Nichols 1987: 889).

RPSV (for ‘Root Pooled Spatial Variance’) is a measure of the 2-D dispersion of the locations at which individual animals are detected, pooled over individuals (cf Calhoun and Casby 1958, Slade and Swihart 1983).

Usage

1
2
3
4
5
dbar(capthist, userdist = NULL, mask = NULL)
MMDM(capthist, min.recapt = 1, full = FALSE, userdist = NULL, mask = NULL)
ARL(capthist, min.recapt = 1, plt = FALSE, full = FALSE, userdist = NULL, mask = NULL)
moves(capthist, userdist = NULL, mask = NULL, names = FALSE)
RPSV(capthist, CC = FALSE)

Arguments

capthist

object of class capthist

userdist

function or matrix with user-defined distances

mask

habitat mask passed to userdist function, if required

names

logical; should results be ordered alphanumerically by row names?

min.recapt

integer minimum number of recaptures for a detection history to be used

plt

logical; if TRUE observed range length is plotted against number of recaptures

full

logical; set to TRUE for detailed output

CC

logical for whether to use Calhoun and Casby formula

Details

dbar is defined as –

see pdf manual

When CC = FALSE, RPSV is defined as –

see pdf manual

.

Otherwise (CC = TRUE), RPSV uses the formula of Calhoun and Casby (1958) with a different denominator –

see pdf manual

.

The Calhoun and Casby formula (offered from 2.9.1) correctly estimates σ when trapping is on an infinite, fine grid, and is preferred for this reason. The original RPSV (CC = FALSE) is retained as the default for compatibility with previous versions of secr.

dbar and RPSV have a specific role as proxies for detection scale in inverse-prediction estimation of density (Efford 2004; see ip.secr).

RPSV is used in autoini to obtain plausible starting values for maximum likelihood estimation.

MMDM and ARL discard data from detection histories containing fewer than min.recapt+1 detections.

The userdist option is included for exotic non-Euclidean cases (see e.g. secr.fit details). RPSV is not defined for non-Euclidean distances.

If capthist comprises standalone telemetry data (all detector 'telemetry') then calculations are performed on the telemetry coordinates.

Value

Scalar distance in metres, or a list of such values if capthist is a multi-session list.

The full argument may be used with MMDM and ARL to return more extensive output, particularly the observed range length for each detection history.

Note

All measures are affected by the arrangement of detectors. dbar is also affected quite strongly by serial correlation in the sampled locations. Using dbar with ‘proximity’ detectors raises a problem of interpretation, as the original sequence of multiple detections within an occasion is unknown. RPSV is a value analogous to the standard deviation of locations about the home range centre.

The value returned by dbar for ‘proximity’ or ‘count’ detectors is of little use because multiple detections of an individual within an occasion are in arbitrary order.

Inclusion of these measures in the secr package does not mean they are recommended for general use! It is usually better to use a spatial parameter from a fitted model (e.g., sigma of the half-normal detection function). Even then, be careful that sigma is not ‘contaminated’ with behavioural effects (e.g. attraction of animal to detector) or ‘detection at a distance’.

The argument 'names' was added in 3.0.1. The default names = FALSE causes a change in behaviour from that version onwards.

References

Calhoun, J. B. and Casby, J. U. (1958) Calculation of home range and density of small mammals. Public Health Monograph. No. 55. U.S. Government Printing Office.

Efford, M. G. (2004) Density estimation in live-trapping studies. Oikos 106, 598–610.

Jett, D. A. and Nichols, J. D. (1987) A field comparison of nested grid and trapping web density estimators. Journal of Mammalogy 68, 888–892.

Otis, D. L., Burnham, K. P., White, G. C. and Anderson, D. R. (1978) Statistical inference from capture data on closed animal populations. Wildlife Monographs 62, 1–135.

Slade, N. A. and Swihart, R. K. (1983) Home range indices for the hispid cotton rat (Sigmodon hispidus) in Northeastern Kansas. Journal of Mammalogy 64, 580–590.

See Also

autoini

Examples

1
2
3

Example output

This is secr 3.0.1. For overview type ?secr
[1] 43.71378
[1] 36.35923
[1] 25.62888

secr documentation built on March 18, 2018, 2:11 p.m.