PathPlot: Path plot of BCPA output

In bcpa: Behavioral Change Point Analysis of Animal Movement

Path plot of BCPA output

Description

Plots the animal's trajectory, with segments color-coded according to the time scale / auto-correlation of the BCPA output, and width of segments proportional to the estimated mean of the BCPA.

Usage

PathPlot(
  Data,
  windowsweep,
  type = c("smooth", "flat")[1],
  clusterwidth = 1,
  plotlegend = FALSE,
  tauwhere = "topleft",
  n.legend = 5,
  ncol.legend = 1,
  bty.legend = "n",
  ...
)

Arguments

Data	the track data to be plotted - most typically, output of the GetVT function.
windowsweep	windowsweep object, i.e. the output of the WindowSweep function.
type	whether to plot smooth or flat bcpa output
clusterwidth	for flat BCPA, this is the temporal range within which change points are considered to be within the same cluster.
plotlegend	whether to plot a legend.
tauwhere	where to place the legend for the time-scale / auto-correlation. Can be one of "nowhere", "top", "bottom", "left", "right", "topleft", "topright", "bottomright", "bottomleft".
n.legend	number of labels in legend.
ncol.legend	number of columns in the legend.
bty.legend	whether to draw a box around the legend.
...	additional arguments to pass to the plot base function.

Author(s)

Eliezer Gurarie

Examples

if(!exists("Simp.ws"))
{
 data(Simp)
 Simp.ws <- WindowSweep(GetVT(Simp), "V*cos(Theta)", windowsize = 50, 
 windowstep = 1, progress=TRUE)
}

PathPlot(Simp, Simp.ws, plotlegend=TRUE, n.legend=3)
PathPlot(Simp, Simp.ws, type="flat", clusterwidth=3, plotlegend=TRUE)

bcpa documentation built on May 30, 2022, 5:07 p.m.