conDisplacement: Calculate net displacement from contacts

View source: R/conDisplacement.R

conDisplacementR Documentation

Calculate net displacement from contacts

Description

Calculate the net-displacement (distance) of fixes before and after a contact from that contact point.

Usage

conDisplacement(ltraj, def = "all", idcol = "burst")

Arguments

ltraj

an object of the class ltraj which should be output from the function conPhase.

def

how to define the point-of-contact. The default is to define it as all fixes in a phase type = 'all', alternatively contacts can be defined as a single point along the phase defined as one of: 'first','last','minDist','minTime', which corresponds to the first fix int he contact phase, the last fix in the contact phase, the fix with the minimum time difference and the fix with the closest contact distance.

idcol

column id associated with IDs of individuals, default is the 'burst'

Details

This function is used to compute the net displacement away from contacts by an animal before and after a contact phase. Net displacement represents an important contextual variable, related to the mobility of the individual.

Value

An ltraj object with a new 'displacement' column in infolocs.

References

Long, JA, Webb, SL, Harju, SM, Gee, KL (2022) Analyzing Contacts and Behavior from High Frequency Tracking Data Using the wildlifeDI R Package. Geographical Analysis. 54, 648–663.

See Also

conPhase, conContext

Examples

## Not run: 
data(does)
doecons <- conProcess(does,tc=15*60,dc=50)
doephas <- conPhase(doecons,pc=60*60)
disp_f <- conDisplacement(doephas,def='first')
disp_l <- conDisplacement(doephas,def='last')

## End(Not run)


wildlifeDI documentation built on Nov. 14, 2023, 1:09 a.m.