checkmoves: Check Movements

checkmovesR Documentation

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

CH

single-session secr capthist object

accept

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

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.

Value

Invisibly returns a list with components

badmoves

logical vector with one element for each animal (i.e. each row in CH)

CH

subset of the input CH containing the faulty detection histories

df

dataframe detailing the faulty detections

See Also

linearmask

Examples

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

secrlinear documentation built on Oct. 17, 2023, 9:07 a.m.