annotate_is_first_fixation#

pymovements.measure.reading.annotate_is_first_fixation(fixations: DataFrame, group_columns: list[str]) → DataFrame[source]#

Annotate fixations with a flag indicating the first fixation on a word.

Parameters:

  • fixations (pl.DataFrame) – Fixation-level DataFrame. Must contain a word_idx column.

  • group_columns (list[str]) – Column names used to partition the data into independent reading sequences.

Returns:

Input DataFrame with an additional is_first_fix column.

Return type:

pl.DataFrame