This tool allows collecting gaze data necessary for personal calibration or training of eye-tracking models. It was developed as part of my master's thesis on eye tracking with a monocular webcam. The framework for the full gaze tracking pipeline is also available.
The output is a folder with a CSV file containing the target that the person is looking at in pixels and the file name of the associated webcam image. For good calibration results, it is recommended to take at least 9 calibration images, the more, the better.
pip install -r requirements.txt
- If necessary, calibrate the camera using the provided interactive script
python calibrate_camera.py
, see Camera Calibration by OpenCV. - For higher accuracy, it is also advisable to calibrate the position of the screen as described by Takahashiet al., which provide an OpenCV and matlab implementation.
python main.py --base_path=./data/p00
- This was only tested on Ubuntu 20.10 and Ubuntu 21.04. If you are using macOS or Windows, you might have to supply the monitor parameters manually, e.g.,
--monitor_mm=750,420 --monitor_pixels=1920,1080
, and adjust theTargetOrientation
values inutils.py
.
- This was only tested on Ubuntu 20.10 and Ubuntu 21.04. If you are using macOS or Windows, you might have to supply the monitor parameters manually, e.g.,
- Look at the screen and press the corresponding arrow key where the letter
E
is pointing at when the letter color changes from blue to orange. Please press the arrow key several times because sometimes OpenCV doesn't register the click the first time. - Press the
q
key when the data collection is complete.
- Visualize the recorded data, image by image by running
python visualization.py --base_path=./data/p00
.