User guide#

The user guide explains the main ideas behind pypillometry. Each page gives an overview of a topic and links to the tutorials for worked examples and to the API reference for all parameters.

If you have not used the package before, start with the Quickstart.

Data objects

EyeData; channels; mask layers and policies; pipelines, in-place operations and history.

Data objects
Loading and saving data

Eyelink EDF and ASC files, your own arrays, example datasets and saved objects.

Loading and saving data
Units

Give times, distances and angles with units: 3 * u.min, "200 ms", 60 * u.cm.

Units
Preprocessing

Blinks, gaze artifacts, filtering, downsampling, scaling and combining the eyes.

Preprocessing
Missing data

Blinks, off-screen gaze, excluded periods and interpolation: where the reason for each bad sample is stored and what each method does with it.

Missing data
Gaze data and the setup

Gaze coordinates, the screen and camera geometry, conversion to degrees, off-screen and divergent samples, gaze plots and regions.

Gaze data and the experimental setup
Regions of interest

Regions of the screen; where the gaze is around events, fixation curves, dwell time and first entry per trial.

Regions of interest
Data quality

A quality report with labeled measures (missing data, noise, blinks, calibration) and how the thresholds were chosen.

Data quality
Events, intervals and segments

Select events, build time windows around them, cut the data into segments and compute event-related pupil dilations.

Events, intervals and segments
Plotting

Time series, blinks, intervals, heatmaps and scanpaths.

Plotting
Interactive tools

A fast viewer for long recordings and a tool for tuning parameters while you watch the result.

Interactive tools
Modeling the pupil signal

Separate the signal into a slow baseline and event-related responses.

Modeling the pupil signal
Studies with many participants

Load a whole study from a local folder or from OSF with a configuration file.

Studies with many participants
Settings and logging

Package-wide defaults and how much the package tells you about what it does.

Settings and logging