Default Settings

PyeLink uses validated default settings for all EyeLink tracker configuration. All values below are auto-generated from the source code and will stay in sync with any code changes.

File Settings

Setting	Default	Description
`filename`	`"test"`	EDF filename without .edf extension.
`filepath`	`"./"`	Directory where EDF file will be saved locally.
`enable_long_filenames`	`True`	Enable long filename support on EyeLink Host PC.
`max_filename_length`	`64`	Maximum filename length when long filenames are enabled.

Sampling Settings

Setting	Default	Description
`sample_rate`	`1000`	Sampling rate in Hz.

Calibration Settings

Setting	Default	Description
`n_cal_targets`	`9`	Number of calibration points.
`enable_automatic_calibration`	`True`	Enable automatic sequencing of calibration targets.
`pacing_interval`	`1000`	Minimum time (ms) between target presentation in automatic mode.
`calibration_corner_scaling`	`1.0`	Distance of corner calibration targets from screen edge.
`validation_corner_scaling`	`1.0`	Distance of corner validation targets from screen edge.
`calibration_area_proportion`	`(0.88, 0.83)`	[width, height] proportion of screen used for calibration targets.
`validation_area_proportion`	`(0.88, 0.83)`	[width, height] proportion of screen used for validation targets.

Target Appearance

Setting	Default	Description
`target_type`	`"ABC"`	Calibration target type.
`target_image_path`	`None`	Path to custom target image file.
`cal_background_color`	`(128, 128, 128)`	RGB background color for calibration screen.
`calibration_instruction_text`	`"C to calibrate \| V to validate \| Ente..."`	Instruction text displayed on calibration screen.
`calibration_text_color`	`(255, 255, 255)`	RGB text color for calibration instructions.
`calibration_text_font_size`	`18`	Font size for calibration instruction text.
`calibration_text_font_name`	`"Arial"`	Font name for calibration instruction text.
`calibration_instruction_page_callback`	`None`	Custom callback to replace default calibration instruction page.
`fixation_center_diameter`	`0.075`	Center dot diameter in degrees of visual angle (‘A’ component).
`fixation_outer_diameter`	`0.45`	Outer ring diameter in degrees of visual angle (‘B’ component).
`fixation_cross_width`	`0.1275`	Cross width in degrees of visual angle (‘C’ component).
`fixation_center_color`	`(0, 0, 0, 255)`	RGBA color for center dot.
`fixation_outer_color`	`(0, 0, 0, 255)`	RGBA color for outer ring.
`fixation_cross_color`	`(255, 255, 255, 0)`	RGBA color for cross.
`circle_outer_radius`	`15`	Outer radius in pixels for CIRCLE target type.
`circle_inner_radius`	`5`	Inner radius in pixels for CIRCLE target type.
`circle_outer_color`	`(0, 0, 0)`	RGB color for circle outer ring (CIRCLE target type).
`circle_inner_color`	`(128, 128, 128)`	RGB color for circle center (CIRCLE target type).

Screen Physical Settings

Setting	Default	Description
`screen_res`	`(1280, 1024)`	[width, height] screen resolution in pixels.
`screen_width`	`376.0`	Physical screen width in millimeters.
`screen_height`	`301.0`	Physical screen height in millimeters.
`camera_to_screen_distance`	`475.0`	Distance from camera to screen in millimeters.
`screen_distance`	`None`	Distance from participant’s eye to screen center in millimeters.
`screen_distance_top_bottom`	`(960.0, 1000.0)`	[top, bottom] distances from eye to screen edges in millimeters.
`camera_lens_focal_length`	`38`	Camera lens focal length in millimeters.

Display Backend

Setting	Default	Description
`backend`	`"pygame"`	Display backend for rendering.
`fullscreen`	`True`	Run display in fullscreen mode.
`display_index`	`0`	Monitor index for display.

Tracking Settings

Setting	Default	Description
`pupil_tracking_mode`	`"CENTROID"`	Pupil tracking algorithm.
`pupil_size_mode`	`"AREA"`	How pupil size is reported in data.
`heuristic_filter`	`(1, 1)`	[link, file] heuristic filter levels for noise reduction.
`set_heuristic_filter`	`True`	Whether to activate the heuristic filter.
`enable_dual_corneal_tracking`	`False`	Enable tracking of secondary corneal reflections.

Data Recording

Setting	Default	Description
`file_event_filter`	`"LEFT,RIGHT,FIXATION,SACCADE,BLINK,MES..."`	Events to record to EDF file.
`link_event_filter`	`"LEFT,RIGHT,FIXATION,SACCADE,BLINK,MES..."`	Events to send over ethernet link (real-time).
`link_sample_data`	`"LEFT,RIGHT,GAZE,GAZERES,AREA,STATUS,H..."`	Sample data fields to send over link (real-time).
`file_sample_data`	`"LEFT,RIGHT,GAZE,GAZERES,AREA,HREF,PUP..."`	Sample data fields to record to EDF file.
`record_samples_to_file`	`True`	Record sample data to EDF file.
`record_events_to_file`	`True`	Record event data to EDF file.
`record_sample_over_link`	`True`	Send sample data over ethernet link (real-time).
`record_event_over_link`	`True`	Send event data over ethernet link (real-time).

Hardware Settings

Setting	Default	Description
`enable_search_limits`	`True`	Enable search limits for pupil detection.
`track_search_limits`	`False`	Track pupil to search limits boundary.
`autothreshold_click`	`True`	Auto-adjust threshold on mouse click in camera setup.
`autothreshold_repeat`	`True`	Repeat auto-threshold if pupil not centered on first attempt.
`enable_camera_position_detect`	`True`	Camera position detection on click/auto-threshold.
`illumination_power`	`2`	IR illumination power level (elcl_tt_power).
`host_ip`	`"100.1.1.1"`	IP address of EyeLink Host PC, or “dummy” for dummy mode.

Physical Setup

Setting	Default	Description
`el_configuration`	`"BTABLER"`	EyeLink physical configuration type.
`eye_tracked`	`"BOTH"`	Which eye(s) to track.