tourr (version 0.5.1)

animate: Animate a tour path.

Description

This is the function that powers all of the tour animations. If you want to write your own tour animation method, the best place to start is by looking at the code for animation methods that have already implemented in the package.

Usage

animate(data, tour_path = grand_tour(),
    display = display_xy(), start = NULL, aps = 1,
    fps = 30, max_frames = Inf, rescale = TRUE,
    sphere = FALSE, ...)

Arguments

data

matrix, or data frame containing numeric columns

tour_path

tour path generator, defaults to 2d grand tour

start

projection to start at, if not specified, uses default associated with tour path

display

takes the display that is suppose to be used, defaults to the xy display

aps

target angular velocity (in radians per second)

fps

target frames per second (defaults to 30)

max_frames

the maximum number of bases to generate. Defaults to Inf for interactive use (must use Ctrl + C to terminate), and 1 for non-interactive use.

rescale

if true, rescale all variables to range [0,1]?

sphere

if true, sphere all variables

...

ignored

Value

• an (invisible) list of bases visited during this tour

Details

See render to render animations to disk.

References

Hadley Wickham, Dianne Cook, Heike Hofmann, Andreas Buja (2011). tourr: An R Package for Exploring Multivariate Data with Projections. Journal of Statistical Software, 40(2), 1-18. http://www.jstatsoft.org/v40/i02/.

Examples

f <- flea[, 1:6]
animate(f, grand_tour(), display_xy())
# or in short
animate(f)
animate(f, max_frames = 30)

animate(f, max_frames = 10, fps = 1, aps = 0.1)