fixation_plot_2d: Plot fixations vs. individual sample coordinates in 2D space.

In kollaR: Event Classification, Visualization and Analysis of Eye Tracking Data

Plot fixations vs. individual sample coordinates in 2D space.

Description

This function plots and returns a ggplot2 figure showing fixations and individual gaze coordinates plotted against time. The interval to plot can be defined as a proportion of the data frame or by sample numbers. This function uses one data.frame with fixations and one with sample-by-sample raw data

Usage

fixation_plot_2d(
  raw.data,
  fixation.data,
  plot.window = c(NA, NA),
  raw.columns = c("x.raw", "y.raw"),
  fixation.columns = c("x", "y"),
  fixation.radius = 40,
  xres = 1920,
  yres = 1080,
  xmin = 1,
  ymin = 1,
  order.vertical = FALSE,
  font.size = 15,
  verbose = TRUE
)

Arguments

raw.data	gaze matrix which must include columns for x and y coordinates in the and raw data (single samples) as specified in the raw.columns parameter
fixation.data	Data frame with fixation data which must include columns for fixation x and y coordinates as specified in the fixation.columns parameter as well as the variable onset which indicates the onset of the fixation. Make sure the onset varables match the timing in the raw.data df
plot.window	vector defining the time window to plot. If left empty, the 50-65 <0, they are assumed to be proportions, e.g., plot.window = c(0.3,0.35) plots the 30-35 percent of max.length interval of the data. Numbers >1 are assumed to refer to sample order in the data
raw.columns	Names of variable containing raw data. Default x.raw and y.raw
fixation.columns	Names of variable containing filtered data. Default x and y
fixation.radius	Radius of circles showing fixations.
xres	Maximum of the X axis (horizontal resolution of the screen or area to plot on). Default 1920
yres	Maximum of the Y axis (vertical resolution of the screen or area to plot on). Default 1080
xmin	Minimum of the X axis (default 1).
ymin	Minimum of the Y axis (default 1)
order.vertical	If TRUE, stack subplots on top of each other in a single column
font.size	Text font size
verbose	if TRUE, print the resulting plot

Value

a ggplot of raw and fixated values plotted on the y axis and sample number on the x axis

kollaR documentation built on June 8, 2025, 10:03 a.m.