Eyetracking
Courtesy of icua, matbii supports eye-tracking out of the box. Currently only tobii pro eye trackers are supported. If you want to make use of another eyetracker brand, see this section.
Eye tracking can be configured via the main configuration file.
-
uri (str | None): The eye tracker address (example:'tet-tcp://172.28.195.1'). If left unspecifiedmatbiiwill attempt to find an eye tracker. Defaults to:None(unspecified). -
sdk (str): The eye tracking SDK to use, current options are:['tobii']. Defaults to:'tobii'. -
enabled (bool): Whether eye tracking is enabled. Defaults to:False. -
moving_average_n (int): The window size to used to smooth eyetracking coordinates. Defaults to:5. -
velocity_threshold (float): The threshold on gaze velocity which will determine saccades/fixations. This is defined in screen space, where the screen coordinates are normalised in the range [0,1]. IMPORTANT NOTE: different monitor sizes may require different values, unfortunately this is difficult to standardise without access to data on the gaze angle (which would be monitor size independent). Defaults to:0.5.
matbii does not currently support calibrating eye trackers as part of the task, this should be done via tools provided by your eyetracker manufacturer.
Tobii eye trackers can be calibrated using tobii eye tracker manager. This is also where you will find your eyetracker URI (see section below).
The URI is used by matbii to locate and connect to your eye tracker device, see guides below to find it.
Tobii eye tracker URIs can be found in the tobii eye tracker manager. Once your eye tracker device is setup and connected, it should appear in the manager window. The URI (address) is displayed as below:
Like all devices eye trackers are encapsulated in IOSensors, the EyetrackerIOSensor allows an agent to observe events that come from an IO stream.
TODO