build_word_level_table#

pymovements.measure.reading.build_word_level_table(words: DataFrame, fixations: DataFrame) → DataFrame[source]#

Join all reading measures onto a word-level table.

Computes every individual reading measure and left-joins them onto words, filling missing values with 0. Derived measures (TFT, FPF, RR, SFD) are appended as final columns.

Parameters:

  • words (pl.DataFrame) – Base word table containing at least trial, page, and word_idx columns (one row per word).

  • fixations (pl.DataFrame) – Annotated fixation table as produced by annotate_fixations().

Returns:

Word-level table with all reading measures as additional columns: TFC, FD, FFD, FPRT, FRT, RRT, FPFC, TRC_in, TRC_out, LP, SL_in, SL_out, RPD_inc, RPD_exc, RBRT, TFT, FPF, RR, and SFD.

Return type:

pl.DataFrame