Learn R Programming

⚠️There's a newer version (2.3.3) of this package.Take me there.

SDLfilter

Overview

SDLfilter contains a variety of functions to screen GPS and/or Argos locations, and to plot them on a map.

Installation

# The official version from CRAN:
install.packages("SDLfilter")

# Or the development version from GitHub:
install.packages("devtools")
devtools::install_github("TakahiroShimada/SDLfilter")

Usage

There are three main filtering functions.

  1. dupfilter removes temporal and spatial duplicates.

  2. ddfilter removes locations with high error.

  3. depthfilter removes fixes located at a given height from estimated high tide line (e.g. locations on land).

Please see the help pages and Shimada et al. (2012, 2016) for more details.

library(SDLfilter)

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

### Remove temporal and spatial duplicates
turtle.dup <- dupfilter(turtle)

### Remove biologically unrealistic fixes 
turtle.dd <- ddfilter(turtle.dup, vmax=9.9, qi=4, ia=90, maxvlp=2.0)

### Plot the locations on a map
# unfiltered
plotMap(turtle, point.size = 2, line.size = 0.5, axes.lab.size = 0)

# filtered
plotMap(turtle.dd, point.size = 2, line.size = 0.5, axes.lab.size = 0,
        bgmap = "satellite", sb.line.col = "white", sb.text.col = "white")

References

If you use the function ddfilter, please cite

Shimada T, Jones R, Limpus C, Hamann M (2012) Improving data retention and home range estimates by data-driven screening. Mar Ecol Prog Ser 457:171-180 http://dx.doi.org/10.3354/meps09747

If you use the functions dupfilter or depthfilter, please cite

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

Current version

1.2.1 (19 February 2019)

Copy Link

Version

Install

install.packages('SDLfilter')

Monthly Downloads

371

Version

1.2.1

License

GPL-2 | file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Takahiro Shimada

Last Published

February 27th, 2019

Functions in SDLfilter (1.2.1)

depthfilter

Filter locations by water depth
distance_filter

Filter locations by distance
turtle

Green turtle tracking data
turtle2

Green turtle tracking data 2
Australia

A map of Australia
SandyStrait

A map of Sandy Strait, Australia
dupfilter.qi

Filter temporal duplicates by quality index
dupfilter

Filter temporal and/or spatial duplicates
dupfilter.exact

Filter temporally and spatially exact duplicates
dupfilter.space

Filter spatial duplicates
est.vmax

Estimate maximum linear speed
plotMap

Plot location data
ddfilter.loop

Filter locations by quality index, inner angle, and speed
ddfilter.speed

Filter locations by speed
tidalplane

Tidal plane table for Sandy Strait, Australia
tidedata

Tidal data for Sandy Strait, Australia
bathymodel

Bathymetry model for Sandy Strait, Australia
ddfilter

Filter locations using a data driven filter
dupfilter.time

Filter temporal duplicates
est.maxvlp

Estimate maximum one-way linear speed of a loop trip