GetVT: Obtain VT table from Track

Description Usage Arguments Value Author(s) See Also Examples

View source: R/GetVT.r

Description

The VT table containes speeds, steplengths, orientations and other summaries derived from a track. The output of this function is (typically) meant to feed the WindowSweep function.

Usage

1
GetVT(Data, units = "hour", skiplast = TRUE)

Arguments

Data

a track to analyze. Must contain columns: X, Y and Time (as a POSIX object). The track class is a robust entry.

units

the time units for the analysis; one of sec, min, hour, day.

skiplast

filters away last step.

Value

a data frame with the following columns:

Z.start, Z.end

the start and end locations (as complex coordinates)

S

the step length

Phi, Theta

absolute and turning angle, respectively

T.start, T.end

start and time of steps (numeric - in given units)

T.mid

temporal midpoint of the step

dT

duration of the step

V

approximate speed (S/dT)

T.POSIX

the temporal midpoint of the step as a POSIX objects.

Author(s)

Eliezer Gurarie

See Also

WindowSweep

Examples

1
2
3
4
5
6
7
8
9
data(Simp)
plot(Simp)
Simp.VT <- GetVT(Simp)
head(Simp.VT)
# Distribution of estimated speeds
hist(Simp.VT$V, col="grey", breaks=20)
# Distribution of turning angles
require(circular)
rose.diag(Simp.VT$Theta, bins=24)

bcpa documentation built on May 1, 2019, 10:30 p.m.