moveParams: Estimate movement parameters from timestamped xy data

In ndow-wisr/rNDOW: R Package For NDOW

Description

The function will estimate common movement parameters from the given xy coordinates and timestamp data. The data can be returnded by itself as a data.table or added to an existing data.table.

Usage

moveParams(df, xyti = c("x", "y", "timestamp", "ndowid"), format = NULL)

Arguments

format	Format of the date time string to be passed to the as.POSIXct. The default is NULL assuming that timestamps will be in the "standard unambiguous format", i.e. YYYY-MM-DD HH:MM:SS. If the timestamp is already of class POSIXct, this isn't required.
x	The x component of the xy data
y	The y component of the xy data
timestamp	The timestamp of the xy data
dat	Additional data for the returned data to be added to (optional)

Value

a data.table with the following columns:

dist	the distance between xy locations (meters)
nsd	net squared displacement (meters)
dt	duration between xy locations (seconds)
speed	velocity between xy locations (km/hr)
phi, theta	absolute and turning angle (respectively)
vp	persistence velocity
vt	turning velocity

Author(s)

Mitchell Gritts

Examples

df <- moveParams(df$X, df$Y, df$timestamp, dat = df, format = '%Y-%m-%d %H:%M:%S')

ndow-wisr/rNDOW documentation built on May 23, 2019, 1:28 p.m.