Comparing scanpaths using combinatorial spatio-temporal sequences with fractal curves.
This code should accompany the paper by the same name and is tested on Matlab R2020b. Three experiments are referenced in the paper and steps to reproduce their findings are below.
Please set paths in Matlab to the root directory of this repository and include subpaths.
Folder Preprocessing/ contains three files:
Scanpath_Preprocessing.m - starting point for preprocesing, iterating through all the stimuli to calculate hilbert curves.
Scanpath_DataPrep.m - remove unused columns and feeding cells to the hilbert function.
HilbertCurve.m - convert (x,y) eye tracking coordinates into (h) hilbert curve locations.
Preprocessed Data Folder Preprocessed Data/
The preprocessed data folder contains the names of files with a 'C0' or 'R' or 'NMQ' or 'Cpilot' prefix. These mixed names were used by the data collector to organise the collection of the eye tracking experiment and do not impact this study. Therefore, after processing the data into hilbert curve locations, a unform naming structure using the letter P for all participants, e.g., P01_bluespot.txt, will be used.
Post Processed Data Folder Data/Bluepoles
Post Processed Data Folder Data/BlueSpot
Post Processed Data Folder Data/Convergence
Post Processed Data Folder Data/Pasiphae
Post Processed Data Folder Data/StarryNight
Post Processed Data Folder Data/Turner
Structure: x, y, t, h represent x fixation position, y fixation position, t fixation duration in milliseconds, and h Hilbert distance, respectively.
Inside the folder RandomScanpathExperiment open the file RandomScanpath_Experiment.m and run it in Matlab.
Inside the folder RandomScanpathExperiment open the file RandomScanpath_plot.m and run it in Matlab to see the plot.
Please note: Due to the random nature of this experiment, the plot may not be an exact match for the one in the paper.
Inside the folder RealScanpathExperiment open the file SoftMatchOptimiseAndPlot.m and run it in Matlab.
This will return optimisation plots for SoftMatch tau and delta parameters.
Please note: due to the random nature of this experiment, this plot may not be an exact match for the one in the paper.
Inside the folder RealScanpathExperiment open the file MultiMatchAnalysis.m and run it in Matlab.
This will create heatmaps for MultiMatch.
Inside the folder RealScanpathExperiment open the file SoftMatchAnalysis.m and run it in Matlab.
This will create heatmaps for SoftMatch.
MultiMatch (Dewhurst et al.) was kindly provided for this research by Marcus Nyström marcus.nystrom@humlab.lu.se.
The only change made to MultiMatch was to increase the resolution to 1920 x 1080 on line 8 in file doComparison.m..
ScanMatch (Cristino et al.) The ScanMatch toolbox for MATLAB is freely available online (www.scanmatch.co.uk).
The only change made to ScanMatch was to increase the resolution to 1920 x 1080 on line 32 and 33 in file ScanMatch_Struct.m..
Unique values for tests are illustrated below. Tests can be found in the Statistics folder.
