Compute Similarity Between Scanpaths

This function computes the similarity between two scanpaths using a specified method.

Usage

# S3 method for class 'scanpath'
similarity(
  x,
  y,
  method = c("multimatch"),
  window = NULL,
  screensize = NULL,
  ...
)

Arguments

x

A scanpath object containing the first scanpath.

y

A scanpath object containing the second scanpath.

method

A character string specifying the method to compute the similarity (default is "multimatch").

window

A numeric vector of length 2 specifying the time window to restrict the fixations in the input scanpaths (default is NULL, which considers all fixations).

screensize

A numeric vector of length 2 specifying the dimensions of the screen (e.g., c(1000, 1000)). Required for the "multimatch" method.

...

Additional arguments passed to the similarity computation method.

Value

A numeric value representing the similarity between the two input scanpaths.

See also

Other similarity: similarity()

Examples

# Create two scanpaths from fixation groups
fg1 <- fixation_group(x = c(100, 200, 300), y = c(100, 150, 200),
                      onset = c(0, 200, 400), duration = c(200, 200, 200))
fg2 <- fixation_group(x = c(110, 210, 290), y = c(110, 140, 210),
                      onset = c(0, 200, 400), duration = c(200, 200, 200))
sp1 <- scanpath(fg1)
sp2 <- scanpath(fg2)
similarity_value <- similarity(sp1, sp2, method = "multimatch", screensize = c(1000, 1000))