Difference between revisions of "Dikablis Mobile Eye-Tracking System"

From REALab Wiki
Jump to navigation Jump to search
Line 31: Line 31:


Although these programs can be installed on any computer using the Dikablis installation CD, the Recorder should only be used with the Dell laptop as it has been optimally configured for recording.  Note also that the appropriate license stick must be plugged in to use all software except the Dikablis Player.
Although these programs can be installed on any computer using the Dikablis installation CD, the Recorder should only be used with the Dell laptop as it has been optimally configured for recording.  Note also that the appropriate license stick must be plugged in to use all software except the Dikablis Player.


=== Calibrating and Recording ===
=== Calibrating and Recording ===
Line 53: Line 54:


Data is saved in the "online" folder of the subject specified.  This is distinguised from the "offline" folder, which is where data is saved after offline editing.  After recording, 3 files are saved to the online folder: the field-cam *.avi video, eye-cam *.avi video and a *.txt file with the prefix "journal" which includes keyboard and network event triggers.  ''Note that videos exceeding 1GB in size are split up, but automatically put back together in the Player and Analyis software.''
Data is saved in the "online" folder of the subject specified.  This is distinguised from the "offline" folder, which is where data is saved after offline editing.  After recording, 3 files are saved to the online folder: the field-cam *.avi video, eye-cam *.avi video and a *.txt file with the prefix "journal" which includes keyboard and network event triggers.  ''Note that videos exceeding 1GB in size are split up, but automatically put back together in the Player and Analyis software.''


=== Playing Back ===
=== Playing Back ===

Revision as of 19:04, 3 April 2012

Hardware Setup

The Dikablis system in the real room consists of the following hardware and accessories:

  • Recording computer including power pack (dell laptop)
  • Two USB/mini USB cables
  • Frame grabber box for the eye camera
  • Frame grabber box for the field camera
  • Video cable
  • Cable box including power pack
  • Head unit
  • Battery charger, 2 batteries (not shown below)
  • Shoulder bag to hold the cable box and one battery (not shown below)


Software use is enabled by:

  • Recording license stick
  • Analysis license stick
  • Dikablis installation CD


Assembly

Dikablis Assembly.png


To start using the Dikablis, make sure the hardware is assembled as shown. Start up the laptop, and turn on the cable box (gently pull and switch the toggle). Make sure the recording license stick is plugged in, and open the recording software on the desktop.

Dikablis Software

The following programs are on the desktop of the Dell laptop: Dikablis Recorder 2.0, Dikablis Player 2.0, Control Centre 1.0, Marker Detector 2.1, D-Lab Essential 2.0, and Dikablis Analysis 2.0. These are briefly described below, in the order in which they would typically be run to test and then analyze one subject's data.


Although these programs can be installed on any computer using the Dikablis installation CD, the Recorder should only be used with the Dell laptop as it has been optimally configured for recording. Note also that the appropriate license stick must be plugged in to use all software except the Dikablis Player.


Calibrating and Recording

Dikablis Recorder is used to calibrate eye-tracking and record eye-cam and field-cam videos during the testing session.


Before opening Dikablis Recorder, make sure that the hardware is assembled properly. If so, open Recorder and you should see video from the eye and/or field cams, and be able to switch or blend the videos using the visualization options in the lower-right panel. Make adjustments to the field camera so that it shows what the participants is seeing *link*.


Dikablis Recorder.png


To begin testing a new subject, open an existing project or create a new one, then create a new subject within that project. Note: When creating a project, you can define triggers- timestamped events in the *.txt journal file, of key presses or network events- for all subjects in that project. However, these require manual analysis, i.e., they can't be analyzed by Dikablis software. If you need to send or receive events by network connection, you can connect an ethernet cable to another computer- wait for network symbol to indicate 'connected'.


Next, start the calibration wizard. When instructed, adjust the eye-camera gently so that left pupil is centered in square (note: the eye-cam is meant to film only the left eye- don't try to bend it towards the right eye!). Next, you can mask dark areas such as eyelashes and set a threshold to optimize pupil detection. Have the participant look around to make sure the pupil is still detected. There's also an expert mode pupil detection option. Next, calibrate to synch up the eye and field cams by having the participant look at one point in each quadrant of the environment, and marking these points in the Recorder software with a mouse click. You should calibrate from the same distance as when testing. When you are done calibrating, click finish.


Press 'start record' when you want to start recording, and 'stop record' when your experiment ends. You can repeat to add further recordings to the participant. It is possible to manually calibrate while recording- to do this, press "start online calibration". You may want to do this if the headset shifts while testing.


Data is saved in the "online" folder of the subject specified. This is distinguised from the "offline" folder, which is where data is saved after offline editing. After recording, 3 files are saved to the online folder: the field-cam *.avi video, eye-cam *.avi video and a *.txt file with the prefix "journal" which includes keyboard and network event triggers. Note that videos exceeding 1GB in size are split up, but automatically put back together in the Player and Analyis software.


Playing Back

You can use Dikablis Player to play back the video you recorded using Dikablis Recorder. Note that this is not used for analysis.

To start the Player after recording and automatically load the video just recorded, click the Start Player button in Dikablis Recorder. Otherwise click on Dikablis Player on the desktop.



control center

- used to stream data to another computer? configure which events get sent to network?


Marker Detector

-run marker detector to detect markers in the video recorded by the field camera -

Manual Recalibration

-only if you know where subject looked during particular frame

-Dikablis anlayis software -open to subject- choose the frame(s) where you know where the subject was looking, e.g., fixation cross frames -click on start calibration -can manually adjust position x and y to where the subject was known to be looking -click on add, and it will add your adjustment -can continue doing this, using the slider to identify particular frames -when finished, click stop calibration -file, save as postprocessed subject name

AOIs and Gaze Statistics

-dlab software -import dikablis- select a recording and scene in left panel, can analyze recalibrated files-can add area of interest either for whole project or particular subject, can calculate gaze statistics, e.g., how often/long looked at region -click new, define using left and right clicks, select marks, press ok -compute gaze behaviour