This shows you the differences between two versions of the page.

Link to this comparison view

staff:weinert:eyetracking [2019-06-18 11:21] (current)
Line 1: Line 1:
 +====== Eyetracking Utilities ======
 +On this page you can download software that can be used to produce gazeplots on video material.
 +The software was originally produced to be used by students taking the course [[fischer:​teaching:​dif-ss2019|Diagnose und individualle Förderung]].
 +During this course the students recorded and analysed pupils activities while performing programming tasks.
 +Eyetracking was used to show the students, what a learner would focus on, during programming.
 +The software suite consists of two programs:
 +  * The //​Gazelogger//,​ used to record eyetracking data
 +  * The //​Gazeplotter//,​ used to overlay a video file with recorded eyetracking data
 +===== Gazelogger =====
 +{{ :​staff:​weinert:​eyetracking:​gazelogger.zip |Download}}
 +=== Requirements ===
 +To use the Gazelogger, you need to run the gazepoint API or another software that connects to the eyetracking hardware.
 +This software has to provide a TCP-server that communicates in accordance to the //Open Gaze API by Gazepoint//​.
 +=== Usage ===
 +The Gazelogger provides a GUI that is used to begin and end the logging process.
 +Logs are created in the directoy from which the program has been started.
 +===== Gazeplotter =====
 +{{ :​staff:​weinert:​eyetracking:​gazeplotter.zip |Download}}
 +=== Requirements ===
 +The Gazeplotter internally uses the program //ffmpeg// to transcode video files.
 +Since it is not included in the download above, you need to obtain it elsewhere.
 +To allow the Gazeplotter accessing it, you can either add its directory to the PATH or provide its location via an argument (see below for details).
 +=== Usage ===
 +== Basic ==
 +In each case you need to provide the program with a video file and a gazelog. If these fines are names //​input.avi//​ and //​gazelog.glog//​ respectively,​ aou can start the plotting process with
 +<​code>​java -jar GazePlotter.jar</​code>​
 +otherwise provide the files by using the arguments //-i// and //-g//:
 +<​code>​java -jar GazePlotter.jar -i inputfile -g gazelogfile</​code>​
 +== Advanced ==
 +You can use the following options to further configure the plotting process:
 +^ Option ^ Parameter ^ Default ^ Description ^
 +| -h     ​| ​  ​- ​      ​| ​  ​- ​    | Prints help text that describes usable arguments |
 +| -fp    | path | ffmpeg | Path to access //ffmpeg// |
 +| -i     | path | input.avi | Path to file that will be overlayed with plot |
 +| -o     | path | //algorith name// | Path to file that will be written as output |
 +| -g     | path | gazelog.glog | Path to file from which eyetracking data will be loaded |
 +| -sa    | algorithm | MEAN_8 | Algorithm to be used during plotting (see below) |
 +| -r     | rate | 30 | Framerate to be used as transcoding target |
 +| -ts    | seconds | 0 | Amount of seconds (decimal point allowed) to be skipped at the beginning of the input video |
 +Available plotting algorithms (can be optained with argument //-sa LIST//):
 +^ Algorithm name ^ Description ^
 +| RAW | Plot recorded points without preprocessing |
 +| MEAN_4 ​  | Replace raw coordinates with mean position of the last 4 points* |
 +| MEAN_8 ​  | Replace raw coordinates with mean position of the last 8 points* |
 +| MEAN_16 ​ | Replace raw coordinates with mean position of the last 16 points* |
 +*From the described points the subset is used that contains only valid points
Last modified: 2019-06-18 11:21 (external edit)