Learn R Programming

SDLfilter (version 2.0.0)

vmax: Estimate maximum linear speed

Description

Function to estimate the maximum linear speed between two consecutive locations.

Usage

vmax(sdata, qi = 5, 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 latitude and longitude of each location 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 lowest quality index of a location that is qualified to be used in the estimation. Default is 5 (e.g. 5 GPS satellite or more).

prob

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

...

Extra arguments passed to dupfilter.

Value

Maximum linear speed (vmax) estimated from the input data. The unit is km/h.

Details

The function first calculates the linear speed between each pair of two consecutive locations. It then 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 linear speed at which an animal would travel between two consecutive locations.

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_speed, track_param, dupfilter