Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

dupfilter

Filter temporal and/or spatial duplicates

Description

Function to filter temporal and spatial duplicates in tracking data and retain only a single fix per time and location.

Usage

dupfilter(sdata, step.time = 0, step.dist = 0, conditional = FALSE)

Arguments

sdata

A data frame containing columns with the following headers: "id", "DateTime", "lat", "lon", "qi". See the data turtle for an example. The function filters the input data by a unique "id" (e.g. transmitter number, identifier for each animal). "DateTime" is the GMT date & time of each location in class POSIXct or character with the following format "2012-06-03 01:33:46". "lat" and "lon" are the latitude and longitude of each location in decimal degrees. "qi" is the quality index associated with each location fix. The input values can be either the number of GPS satellites or Argos Location Classes. Argos Location Classes will be converted to numerical values, where "A", "B", "Z" will be replaced with "-1", "-2", "-3" respectively. The greater number indicates a higher accuracy.
step.time

Consecutive locations less than or equal to step.time apart are considered temporal duplicates. Default is 0 hours.
step.dist

Consecutive locations less than or equal to step.dist apart are considered spatial duplicates. Default is 0 kilometres.
conditional

If TRUE, spatial duplicates are filtered only if they are less than or equal to step.time apart. Default is FALSE.

Details

This function filters temporal and spatial duplicates in tracking data. It first filters temporally and spatially exact locations. It then looks for temporal duplicates and retains a fix with the highest quality index. When temporal or spatial duplicates are associated with the same quality index, the function retains a location that is nearest from a previous and to a subsequent location.

Value

The input data frame is returned containing only a single fix (latitude/longitude pair) per time and location.

Author(s)

Takahiro Shimada

References

Shimada T, Limpus C, Jones R, Hazel J, Groom R, Hamann M (2016) Sea turtles return home after intentional displacement from coastal foraging areas. Marine Biology 163:1-14 doi: 10.1007/s00227-015-2771-0

See Also

Examples

#### Load data sets
## Fastloc GPS data obtained from a green turtle
data(turtle)


#### Apply dupfilter
turtle.dup <- dupfilter(turtle)
SDLfilter

Filtering and Assessing the Sample Size of Tracking Data

v2.1.0
GPL-2 | file LICENSE
Authors
Takahiro Shimada
Initial release
2021-04-02

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.