Differences
This shows you the differences between two versions of the page.
— |
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 |