checkmoves: Check Movements

Description

This function reports problems indicated by extreme movements in a capthist object. At present it is configured for distances measured along a linearmask only.

Usage

checkmoves (CH, accept = c(0, 1000), userdist, mask, showall = TRUE, silent = FALSE)

Arguments

single-session secr capthist object

range of accepted movements in metres; may include Inf

userdist

matrix of distances between all traps(CH) (optional)

mask

linearmask object (optional)

showall

logical; if TRUE the output dataframe includes all detections of each individual with at least one extreme movement

silent

logical; if TRUE then console output is suppressed

Value

Invisibly returns a list with components
badmoveslogical vector with one element for each animal (i.e. each row in CH)
CHsubset of the input CH containing the faulty detection histories
dfdataframe detailing the faulty detections

Details

This function works with Euclidean distances (the default if neither mask nor userdist is specified), non-Euclidean network distances implied by a linear habitat mask, or any distances presented in userdist. Linear habitat masks are prone to breaks (missing edges in the graph representation). If an animal is `recaptured' on both sides of a break then the network distance for that `movement' will be infinite. checkmoves displays the message `All OK' if there are no out-of-range movements, and otherwise displays the number of individuals with out-of-range movements.

Examples

Run this code

out <- checkmoves(captdata, accept = c(0,100))
out