Contents of src

`reformat_asc/`

Contains an original python script that reformats a single ExperimentBuilder .asc data file into one that's compatible with UMass-Amherst analysis software, which will be required to analyze our data.
All blunders are mine
Requires a dictionary mapping lists to its participants, written in lists.py

Contains a python script that calculates each participant's percent accuracy on the questions, which will be required for excluding participants who were paying less attention than desired.
Created by the UMass-Amherst Eyetracking Lab. See the official documentation within this subfolder for details.
I made some small tweaks for ease of changing their values during future replications. No changes were made to the functionality.
- Hard-coded variables: (modify these for future use)
  - INPUT_FOLDER - where the new .asc files live (the compatible ones generated by reformat_asc.py)
  - OUTPUT_FOLDER - where the outputs regarding question accuracy will live
- Added line 44 to print the current file
Also contains an original python script that calculates mean and median question accuracies across participants.

Contains a perl script that generates a .script file, which will be required for make_cnt.
Created by the UMass-Amherst Eyetracking Lab. See the official documentation within this subfolder for details.
I made some small tweaks for ease of changing their values during future replications. No changes were made to the functionality.
- Hard-coded variables: (modify these for future use)
  - $inputfile - where the sentence file lives
  - $outputfile - where the generated .script file will live
  - $xoff - x offset in pixels, only if you have display change; otherwise just use return char.
  - $yoff - y offset in pixels, only if you have display change; otherwise just use return char.
  - $pixrow - number of vertical pixels per row, only if you have display change; otherwise just use return char.
  - $sequence - y or n depending if you want to automatically want to generate sequences
Requires creating a sort of sentence file input (see the official documentation within this subfolder for details).
- Ours is called input_to_scripter.txt. We created it by pasting stimuli into Excel, duplicating some entries, and concatenating some entries with the '^' deliminator.

Contains a python script that generates a .cnt file, which will be required for Robodoc.
Created by the UMass-Amherst Eyetracking Lab. See the official documentation within this subfolder for details.
I made some small tweaks for ease of changing their values during future replications. No changes were made to the functionality.
- Hard-coded variables: (modify these for future use)
  - OUTPUT_FOLDER - where the generated .cnt file will live
  - input_file - the .script file generated by copy_Scripter2.pl
  - delim_char - the region deliminator character in the file that was inputted to copy_Scripter2.pl
  - lowest_cond - the lowest condition number to be analyzed
  - highest_cond - the highest condition number to be analyzed

Contains an R script that performs realignment of eyetracking data, which apparently will be required for Robodoc since this is a multi-line experiment.
Created by the UMass-Amherst Eyetracking Lab. See the official documentation within this subfolder for details.
I made some small tweaks for ease of changing their values during future replications. No changes were made to the functionality.
- Hard-coded parameters:
  - asc_files - where the reformatted .asc files live (the compatible ones generated by reformat_asc.py)
  - fa_dir - where the fix-aligned .asc files will live (this is now v.3 of the .asc's)
  - the rest of the parameters to the fix_align() function; see CohenBRM.pdf for details on how to set each of them
- Added a single line at the very end that calls the given fix_align() function
Suggestion for running fix_align.R: do not use the option to save trial plots as .tiff unless you need them, as they will likely take up the rest of your computer's hard drive space or more, and the program already takes a while to run without it. That is, I suggest setting save_trial_plots=FALSE.
fix_align_visualization.pdf: a visualization of what fix_align.R does with eyetracking fixations (warning: very large file)

Created by the UMass-Amherst Eyetracking Lab. See the official documentation within this subfolder for details.
Requires a parameters file
- Our parameters are demonstrated in limerick_parameters.txt
- See the official documentation for details.
I made some small tweaks for ease of changing their values during future replications. No changes were made to the functionality.
- Hard-coded parameters:
  - OUTPUT_FOLDER - where the various generated files will live
  - INPUT_FOLDER - where the fix aligned .asc files live (the compatible ones generated by copy_fix_align.R)
- Changed the two or three instances of kp.close to kp.close() (it was probably a typo in the original)
- Towards the end of the script (begining from line 1021), I added a loop to fix the mis-pathed entries in files_processed.lst , since i broke the given script by switching it to INPUT/OUTPUT from outside the current directory)

Contains a bunch of analysis software.
Created by the UMass-Amherst Eyetracking Lab. See the official documentation within this subfolder for details.
- ANALASC.doc seems to be the README equivalent for the folder
We are only interested in using the eyedry softward in particular, hence the seprate eyedry/ folder (described in the next section below)
Each comes with a pre-compiled .exe executable that can only be run from Windows Command Prompt, but the C code can compiled with any compiler (we used GCC) on any Mac/Linux/Windows bash terminal.
No interactions were made with this folder besides archiving its contents

Contains the analysis software that we use.
Created by the UMass-Amherst Eyetracking Lab. See the official documentation within the copy_dataanal_714 folder for details.
Instructions for analysis are written in the Usage section of the repo's README.

slightly tweaks the original eyedry output such that we can use it; see eyedry section of the wiki for more info.