get_nback_001#

pypillometry.get_nback_001(cache_dir=None)[source]#

Load the “nback_001” example dataset (downloaded from figshare).

Binocular gaze and pupil data from a 56-minute N-back task (single participant), saved as a pypillometry file. Events mark fixation, stimulus and response in each trial (e.g., run-1_scr-grey_block-1_task-0b_trial-1_stim_target-1).

The behavioural log of the task is merged into the events’ metadata (see Events.meta): run, screen, block, task (0b, 1b, 2b or p) and trial are parsed from the labels, and stimulus, target, response, accuracy and rt (reaction time in s) are added to all events of each trial. The log’s header (date, ambient light, …) is in d.info["behaviour_log"].

The files are downloaded into cache_dir on the first call and reused later. Usually called via get_example_data(). The tutorial Case study: an N-back task analyses this dataset.

Parameters:: cache_dir (str, optional) – directory for the downloaded files; default $XDG_CACHE_HOME/pypillometry (~/.cache/pypillometry)
Return type:: EyeData
Returns:: the example dataset