GazeGenie / trials_df_columns.md
hugpv's picture
initial commit
da572bf
|
raw
history blame
3.38 kB

Column names for Trials Dataframe

Some features were adapted from the popEye R package (github) The if the column depend on a line assignment then a _ALGORITHM_NAME will be at the end of the name.

  • subject: Subject name or ID (derived from filename)
  • trial_id: Trial ID
  • item: Item ID
  • condition: Condition (if applicable)
  • average_y_correction_ALGORITHM_NAME: Average difference between raw y position of a fixation and the center of the line to which it was assigned in pixels
  • Number of fixations before cleaning: Number of fixation found for the trial before any cleaning is done
  • Discard long fixations: Indicates if overly long fixations were discarded
  • Number of discarded long fixations: Number of fixations that were discarded due to being overly long
  • Number of discarded long fixations (%): Number of fixations that were discarded due to being overly long as a percentage of the total number of fixations
  • How short and close fixations were handled: Which option was chosen for handling short fixation
  • Number of merged fixations: Number of fixations that were merged due to their duration being below the set threshold and being in horizontal proximity to their preceeding or subsequent fixation
  • Number of merged fixations (%): Number of fixations that were merged due to their duration being below the set threshold and being in horizontal proximity to their preceeding or subsequent fixation as a percentage of the total number of fixations
  • Far out of text fixations were discarded: Whether fixations were discarded if they were far outside the stimulus text
  • Number of discarded far-out-of-text fixations: Number of fixations that were discarded due to being far outside the stimulus text
  • Number of discarded far-out-of-text fixations (%): Number of fixations that were discarded due to being far outside the stimulus text as a percentage of the total number of fixations
  • Total number of discarded and merged fixations: Number of fixations that were cleaned up
  • Total number of discarded and merged fixations (%): Number of fixations that were cleaned up as a percentage of the total number of fixations
  • trial_start_time: Timestamp of the start of the trial
  • trial_end_time: Timestamp of the end of the trial
  • question_correct: Whether the question associated with the trial was answered correctly. This will be blank if it could not be determined
  • number_of_words_in_trial: Total number of words in the stimulus used for the trial
  • blink: Number of blinks detected during the trial
  • nfix: Number of fixations remaining after cleaning
  • nrun_ALGORITHM_NAME: Number of runs on trial
  • saccade_length_ALGORITHM_NAME: Average saccade length across the trial
  • mean_fix_duration_ALGORITHM_NAME: Average fixation duration across the trial
  • total_fix_duration_ALGORITHM_NAME: Total fixation duration across the trial
  • skip_ALGORITHM_NAME: Proportion of words in the trial that have been skipped during first-pass reading
  • refix_ALGORITHM_NAME: Proportion of words in the trial that have been refixated
  • reg_ALGORITHM_NAME: Proportion of words which have been regressed into
  • firstpass_ALGORITHM_NAME: First-pass reading time
  • rereading_ALGORITHM_NAME: Re-reading time (total reading time minus first-pass reading time)
  • reading_rate_ALGORITHM_NAME: Reading rate (words per minute)