Create pdf with separate plots per trajectory.

Description

mt_plot_per_trajectory creates a PDF file with separate plots per trajectory. This PDF can be used for inspecting individual trajectories. Note that plotting all trajectories can be time-consuming, especially for raw trajectories. If the appropriate x and y arguments are inserted, this function can also be used for plotting velocity and acceleration profiles.

Usage

1
2
3
4
mt_plot_per_trajectory(file, data, use = "trajectories", x = "xpos",
  y = "ypos", xlim = NULL, ylim = NULL, axes_exact = FALSE,
  points = FALSE, rect = NULL, color = "black", fill = NA,
  verbose = FALSE, show_progress = NULL, ...)

Arguments

file

a character string specifying the name of the pdf file. Passed on to pdf.

data

a mousetrap data object created using one of the mt_import functions (e.g., mt_import_mousetrap).

use

a character string specifying which trajectories should be plotted. The corresponding trajectories are selected from data using data[[use]]. Usually, this value corresponds to either "trajectories", "tn_trajectories" or "av_trajectories", depending on whether the raw, time-normalized or averaged trajectories should be plotted.

x

a character string specifying which dimension in the trajectory array should be displayed on the x-axis (defaults to xpos).

y

a character string specifying which dimension in the trajectory array should be displayed on the y-axis (defaults to ypos).

xlim

optional argument specifying the limits for the x axis (passed on to coord_cartesian). If not specified (the default), sensible axis limits will be computed.

ylim

optional argument specifying the limits for the y axis (passed on to coord_cartesian). If not specified (the default), sensible axis limits will be computed.

axes_exact

logical. If TRUE, axes will be set without offset exactly at the limits of the x and y axes (which can be specified using xlim and ylim]).

points

logical. If TRUE, points will be added to the plot using geom_point.

rect

optional argument passed on to mt_plot_add_rect. If specified, rectangles (usually representing the response buttons) will be plotted for each trajectory plot.

color

optional argument passed on to mt_plot_add_rect. Only relevant if rect is specified.

fill

optional argument passed on to mt_plot_add_rect. Only relevant if rect is specified.

verbose

logical indicating whether function should report its progress.

show_progress

Deprecated. Please use verbose instead.

...

additional arguments passed on to pdf.

Details

mt_plot_per_trajectory creates a PDF using pdf. Next, it plots all trajectories individually using mt_plot. Every plot is labeled using the rownames of the trajectories.

See Also

mt_plot for plotting trajectory data.

Examples

1
2
3
4
5
6
## Not run: 
mt_plot_per_trajectory(mt_example,
  file="trajectories.pdf",
  use="trajectories")

## End(Not run)

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.