plot.displacement: Plots the displacement from a particular point over a chosen...

Description Usage Arguments Details Value Author(s) References Examples

View source: R/plot.displacement.R

Description

The displacement from a particular point to every other point along the animal's trajectory is calculated and this is then plotted over a defined window.

Usage

1
2
## S3 method for class 'displacement'
plot(x, y, Name, t, R, t_a, t_1, t_2, ...)

Arguments

x

array of the x-coordinates describing the trajectory

y

array of the y-coordinates describing the trajectory

Name

name of the data, which is used for any saved files and plot titles

t

an array of the times that the positions are recorded at

R

radius value to use

t_a

starting time to calculate the displacement from

t_1

start of interval to view the displacement over

t_2

end of interval to view the displacement over

...

additional arguments to plot

Details

The displacement from a particular time point (t_a) to every other point along the trajectory is calculated and this is then plotted over a defined window [t_1, t_2]. A line representing the radius is also drawn to see when the trajectory enters or leaves the circle centred at the point (t_a). This plot can be used to see how far away the animal moves after leaving a particular circle.

Value

Plot of the displacement

Author(s)

Rhys Munden <[email protected]>

References

Munden, R., Borger , L., Wilson, R.P., Redcliffe, J., Loison, A., Garel, M. and Potts, J.P. in review. Making sense of ultra-high-resolution movement data: an algorithm for inferring sites of interest.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
##Load the data
data(OU_14)
t=unlist(OU_14["t"])
X=unlist(OU_14["X"])
Y=unlist(OU_14["Y"])

class(X) = "displacement"
class(Y) = "displacement"

##Plot the displacement from the starting point (t=0) for t=0 to t=2.9999
plot(X, Y, "OU14", t, 0.3, 0, 0, 2.9999)

SitesInterest documentation built on Oct. 16, 2018, 5:04 p.m.