mt_heatmap plots high resolution raw trajectory maps. Note that this function has beta status.

mt_heatmap(
x,
use = "trajectories",
dimensions = c("xpos", "ypos"),
filename = NULL,
...,
upscale = 1,
plot_dims = FALSE,
verbose = TRUE
)

## Arguments

x usually an object of class mousetrap. Alternatively, a trajectory array or an object of class mt_heatmap_raw. a character string specifying which trajectory data should be used. a character vector specifying the trajectory variables used to create the heatmap. The first two entries are used as x and y-coordinates, the third, if provided, will be added as color information. a character string giving the name of the file. If NULL (the default), the R standard device is used for plotting. Otherwise, the plotting device is inferred from the file extension. Only supports devices tiff, png, pdf. arguments passed to mt_heatmap_raw. a numeric value by which the output resolution of the image is increased or decreased. Only applies if device is one of tiff, png, or pdf. adds the coordinates of the four image corners to the plot. Helps setting bounds. logical indicating whether function should report its progress.

## Details

mt_heatmap wraps mt_heatmap_raw and provides direct plotting output in tiff, png, pdf, or R's default window output. For further details on how the trajectory heatmaps are constructed, see mt_heatmap_raw.

## References

Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 131-145). New York, NY: Routledge.

Kieslich, P. J., Henninger, F., Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: A practical guide to implementation and analysis. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 111-130). New York, NY: Routledge.

mt_heatmap(KH2017, xres=500, n_shades=5, mean_image=0.2)#> spatializing trajectories