DOI: 10.6084/m9.figshare.4742935.v2
title: Materials for Pupillary Responses to Words That Convey a Sense of Brightness or Darkness

description: Experimental resources for the study "Semantic Pupil"<br>=====================================================<br>Copyright 2015-2017 Sebastiaan Mathôt, Kristof Strijkers, JonathanGrainger<br>- s.mathot@cogsci.nl- http://www.cogsci.nl/smathot<br>Table of contents=================<br>- About this repository- Running the experiments- Participant data- Running the analysis- License<br>About this repository=====================<br>This repository contains materials to accompany the followingmanuscript:<br>Mathôt, S., Strijkers, K., & Grainger, J. (in press). Pupillaryresponses to words that convey a sense of brightness or darkness.*Psychological Science*.<br>Running the experiments=======================<br>The experiments are placed in the `experiments` subfoler.<br>All experiments were conducted with[OpenSesame](http://osdoc.cogsci.nl/), but not all with the sameversion.<br>- visual experiment: 2.9.6 (with EyeLink plugins, which need to be installed separately)- ratings experiment: 3.0.0- auditory experiment: 3.1.0- valence-control experiment: 3.1.3<br>Participant data================<br>Eye-tracking data-----------------<br>The eye-tracking data for each experiment is located in`analysis/edf/[experiment name]`. This in `.edf` format, which is theformat used by the EyeLink eye tracker.<br>To run the analysis as described below, the `.edf` files need to beconverted to `.asc` files using the `edf2asc` utility that can bedownloaded for free from the SR Research forum (registration required)<br>The `.asc` files then need to be placed in a folder called`analysis/data-pupil-asc/[experiment name]`. This folder needs to becreated.<br>Ratings data------------<br>The ratings data is located in `analysis/data-ratings`. This in standardcomma-separated values (`.csv`) format.<br>Running the analysis====================<br>Before analyzing the data, the eye-tracking data needs to be convertedas described above.<br>Analysis scripts and participant data are placed in the `analysis`subfolder.<br>IPython notebook----------------<br>For a quick example of how the analysis works, see this IPythonnotebook:<br>- [analysis/basic-analysis.ipynb](analysis/basic-analysis.ipynb)<br>Full analysis pathway---------------------<br>The analysis requires the standard numpy/ scipy stack, and[DataMatrix](https://github.com/smathot/python-datamatrix) and[EyelinkParser](https://github.com/smathot/python-eyelinkparser).<br>First, parse the ratings data by running:<br> python3 analyze-ratings.py<br>This will create a file called `ratings.csv`, which is used for the mainanalyses.<br>Next, run the full analysis for the visual experiment:<br> python3 analyze-pupil.py --auditory @full<br>And for the auditory experiment:<br> python3 analyze-pupil.py --visual @full<br>And for the control experiment:<br> python3 analyze-pupil.py --control @annotated_valence_plot<br>Various other analyses can be performed as well. The logic is that youcan execute a function in one of the analysis modules by passing`@[function name]` as argument.<br>During the analysis, cache files are created. To start from scratch,pass the `--clear-cache` argument.<br>Notes:<br>- *térébrant* was misspelled and therefore removed from the analysis.- *pénombre* occurred twice in the stimulus list of the pupillometry experiment.<br>License=======<br>- Analysis and experimental code are released under a [GNU General Public License 3](https://www.gnu.org/copyleft/gpl.html).- Data and text are released under a [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/).<br>Note: This is a frozen snapshot of the following GitHub repository:<br><br>- https://github.com/smathot/semantic_pupil<br>