====== 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