move (version 3.2.2)

distance: Distance between the locations of a movement track

Description

Calculates the distance between the consecutive locations of a Move or MoveStack object.

Usage

# S4 method for .MoveTrackSingle,missing
distance(x)
  # S4 method for .MoveTrackStack,missing
distance(x)

Arguments

x

a move, moveStack or moveBurst object

Value

Distance in map units. If the projection of the coordinates is long/lat all values are returned in meters, otherwise in the map units of the projection of the move object. For long/lat distance is calculated on a sphere using the ellipsoid, for other projections the calculation is done on a plane using Pythagoras. Check and set the projection of your Move, MoveStack or MoveBurst object using the proj4string() function.

If a move or moveBurst object is provided, a numeric vector one element 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 one element shorter than the number of locations is obtained

Details

pointDistance is used to calculate the distances.

Examples

# NOT RUN {
## distance from a Move object 
data(leroy)
head(distance(leroy))
# to add this information to the move object, a "NA" has to be assigened
# e.g. distance is assigned to the first location of a segment
leroy$distance <- c(distance(leroy), NA)

## distance from a MoveStack object
data(fishers)
str(distance(fishers))
# to add this information to the moveStack object, a "NA" has to be assigened
# e.g. distance is assigned to the first location of a segment
fishers$distance <- unlist(lapply(distance(fishers), c, NA))
# }