TobiiCalibrationSession

TobiiCalibrationSession(
    win,
    calibration_api,
    infant_stims,
    audio=None,
    anim_type='zoom',
    visualization_style='lines',
    verbose=True,
)

Tobii-based calibration session for real eye tracking.

This class implements the calibration protocol for physical Tobii eye trackers, extending the base calibration functionality with hardware-specific data collection and validation. It interfaces directly with the Tobii Pro SDK to collect gaze samples, compute calibration models, and visualize tracking accuracy.

The Tobii calibration process involves presenting targets at known positions, collecting gaze data while participants look at these targets, and computing a mapping between eye features and screen coordinates. This class provides an infant-friendly implementation with animated stimuli and interactive controls.

Methods

Name Description
run Main routine to run the full Tobii calibration workflow.

run

TobiiCalibrationSession.run(calibration_points)

Main routine to run the full Tobii calibration workflow.

This function presents each calibration target, collects gaze data via the eye tracker, shows the results, and allows the user to retry any subset of points until satisfied.

Parameters

Name Type Description Default
calibration_points list of (float, float) List of calibration points in NORMALIZED coordinates [-1, 1]. Will be converted to window units and then to Tobii ADCS format. required

Returns

Name Type Description
bool True if calibration was successful and accepted by user, False if aborted via escape key or if calibration computation failed.
Back to top