interpolate_pupil: Interpolate missing pupil data using linear interpolation

In eyeris: Flexible, Extensible, & Reproducible Pupillometry Preprocessing

Interpolate missing pupil data using linear interpolation

Description

This function fills missing values (NAs) in pupil data using linear interpolation. It uses the zoo::na.approx() function with settings optimized for pupillometry data.

Usage

interpolate_pupil(x, prev_op, verbose, max_gap_ms = 250)

Arguments

x	A data frame containing the pupil time series data
prev_op	The name of the previous operation's output column
verbose	A flag to indicate whether to print detailed logging messages
max_gap_ms	The maximum duration (in milliseconds) of a gap of missing (NA) samples to interpolate. Gaps longer than this are left as NA. Must be greater than 0; use Inf or NULL to interpolate across all gaps. Defaults to 250

Details

Gaps longer than max_gap_ms milliseconds are left as NA rather than interpolated. The threshold is converted from milliseconds to a number of samples using the sampling period of the data (estimated from time_orig), so it is robust to different sampling rates.

This function is called by the exposed wrapper interpolate().

Value

A vector of interpolated pupil values with the same length as the input

eyeris documentation built on Aug. 1, 2026, 1:07 a.m.