turnAngleGc: Turning angles on great circle tracks

In move: Visualizing and Analyzing Animal Track Data

Turning angles on great circle tracks

Description

This function returns the turning angles of a great circle track. This angle represents the relative angle between the consecutive segments.

Usage

  ## S4 method for signature '.MoveTrackSingle'
turnAngleGc(x)

Arguments

x	a move, moveStack or moveBurst object, in long/lat projection

Details

On great circle tracks the bearing of arrival on a point is not the same as witch the previous point was left. This function returns the difference between these bearings between -180 and 180. The bearings are calculated using the functions bearing and finalBearing of the geosphere package.

Value

Angles in degrees (between -180 and 180)

If a move or moveBurst object is provided, a numeric vector two elements shorter than the number of locations is obtained.
If a moveStack object is provided, a list with one element per individual containing a numeric vector two elements shorter than the number of locations is obtained.

Author(s)

Bart Kranstauber & Anne Scharf

See Also

angle

Examples

## turnAngleGc from a Move object 
data(leroy)
head(turnAngleGc(leroy))
# to add this information to the move object, a "NA" has to be assigened
# to the first and last location.
leroy$turnAngleGc <- c(NA, turnAngleGc(leroy), NA)

## turnAngleGc from a MoveStack object
data(fishers)
str(turnAngleGc(fishers))
# to add this information to the moveStack object, a "NA" has to be assigened
# to the first and last location of each individual
fishers$turnAngleGc <-unlist(lapply(turnAngleGc(fishers), function(x) c(NA, x, NA)))

move documentation built on July 9, 2023, 6:09 p.m.