actel (version 1.1.0)

plotMoves: Plot detections for a single tag

Description

The output of plotMoves is a ggplot object, which means you can then use it in combination with other ggplot functions, or even together with other packages such as patchwork.

Usage

plotMoves(
  input,
  tag,
  type = c("stations", "arrays"),
  title,
  xlab,
  ylab,
  col,
  array.alias,
  frame.warning = TRUE
)

Arguments

input

The results of an actel analysis (either explore, migration or residency).

tag

The transmitter to be plotted.

type

The type of y axis desired. One of "stations" (default) or "arrays".

title

An optional title for the plot. If left empty, a default title will be added.

xlab, ylab

Optional axis names for the plot. If left empty, default axis names will be added.

col

An optional colour scheme for the detections. If left empty, default colours will be added.

array.alias

A named vector of format c("old_array_name" = "new_array_name") to replace default array names with user defined ones.

frame.warning

Logical. By default, actel highlights manually changed or overridden tags in yellow and red plot frames, respectively. Set to FALSE to deactivate this behaviour.

Value

A ggplot object.

Examples

# NOT RUN {
# Using the example results that come with actel
plotMoves(example.results, 'R64K-4451')

# Because plotMoves returns a ggplot object, you can store
# it and edit it manually, e.g.:
library(ggplot2)
p <- plotMoves(example.results, 'R64K-4451')
p <- p + xlab("changed the x axis label a posteriori")
p

# You can also save the plot using ggsave!

# }