Learn R Programming

SDLfilter (version 2.0.0)

vmaxlp: Estimate maximum one-way linear speed of a loop trip

Description

Function to estimate the maximum one-way linear speed of a loop trip as described in Shimada et al. (2012).

Usage

vmaxlp(sdata, qi = 4, prob = 0.99, ...)

Arguments

sdata

A data frame containing columns with the following headers: "id", "DateTime", "lat", "lon", "qi". "id" is the unique representing an individual. "DateTime" is date & time in class POSIXct. "lat" and "lon" are the recorded latitude and longitude in decimal degrees. "qi" is the numerical quality index associated with each location fix where a greater number indicates a higher accuracy (e.g. the number of GPS satellites involved in estimation).

qi

An integer specifying the minimum quality index associated with a location used for the estimation. Default is 4 (e.g. 4 GPS satellite or more).

prob

A numeric value to specify a sample quantile. Default is 0.99.

...

Extra arguments passed to dupfilter.

Value

Maximum one-way linear speed of a loop trip (vmaxlp) estimated from the input data. The unit km/h.

Details

The function first detects a "loop trip". Loop trip behaviour is represented by spatial departure and return involving more than 3 consecutive locations (Shimada et al 2012). The function calculates the net (i.e. straight-line) distance between the departure and turning point as well as the turning point and return location of a loop trip. It then calculates the one-way travelling speed to or from each turning point for each loop trip. The function discards extreme values, based on the specified quantile, to exclude potential outliers from the estimation process. The maximum value in the retained dataset (i.e. without outliers) represents the maximum one-way linear speed at which an animal would travel during a loop trip.

References

Shimada T, Jones R, Limpus C, Hamann M (2012) Improving data retention and home range estimates by data-driven screening. Marine Ecology Progress Series 457:171-180 doi:10.3354/meps09747

See Also

ddfilter, ddfilter_loop, track_param, dupfilter