pyavs.preprocess_eye_events

pyavs.preprocess_eye_events(events_df: DataFrame, remove_blinks: bool = True, remove_short_fixations: bool = False, min_fixation_duration: float = 0.1, remove_long_saccades: bool = False, max_saccade_duration: float = 0.1, remove_outlier_positions: bool = True, screen_resolution: Tuple[int, int] = (1024, 768), verbose: bool = False) → DataFrame

Preprocess eye tracking events by removing artifacts and outliers.

Parameters:

• events_df (pd.DataFrame) – Eye tracking events dataframe

• remove_blinks (bool, optional) – Whether to remove blink events (default: True)

• remove_short_fixations (bool, optional) – Whether to remove short fixations (default: False)

• min_fixation_duration (float, optional) – Minimum fixation duration in seconds (default: 0.1)

• remove_long_saccades (bool, optional) – Whether to remove long saccades (default: False)

• max_saccade_duration (float, optional) – Maximum saccade duration in seconds (default: 0.1)

• remove_outlier_positions (bool, optional) – Whether to remove events with outlier positions (default: True)

• screen_resolution (tuple of int, optional) – Screen resolution (width, height) for outlier detection (default: (1024, 768))

• verbose (bool, optional) – Whether to print preprocessing statistics (default: False)

Returns:

Preprocessed events dataframe

Return type:

pd.DataFrame