anim_scanpath: Animate a Fixation Scanpath with gganimate

In bbuchsbaum/eyesim: analysis of eye-movement data

Animate a Fixation Scanpath with gganimate

Description

This function creates an animated visualization of a fixation scanpath using gganimate.

Usage

anim_scanpath(
  x,
  bg_image = NULL,
  xlim = range(x$x),
  ylim = range(x$y),
  alpha = 1,
  anim_over = c("index", "onset"),
  type = c("points", "raster"),
  time_bin = 1
)

Arguments

x	A 'fixation_group' object.
bg_image	An optional image file name to use as the background.
xlim	The range in x coordinates (default: range of x values in the fixation group).
ylim	The range in y coordinates (default: range of y values in the fixation group).
alpha	The opacity of each dot (default: 1).
anim_over	Animate over index (ordered) or onset (real time) (default: c("index", "onset")).
type	Display as points or a raster (default: c("points", "raster")).
time_bin	The size of the time bins (default: 1).

Value

A gganimate object representing the animated scanpath.

See Also

Other visualization: plot.eye_density(), plot.fixation_group()

Examples

# Create a fixation group
fg <- fixation_group(x=c(.1,.5,1), y=c(1,.5,1), onset=1:3, duration=rep(1,3))
# Animate the scanpath for the fixation group
anim_sp <- anim_scanpath(fg)

bbuchsbaum/eyesim documentation built on May 9, 2023, 3:29 a.m.