pyavs.load_pilot_samples¶

pyavs.load_pilot_samples(subjects, data_path, preprocessed=True)[source]¶

Combine enriched gaze samples from all pilot subjects into one DataFrame.

Mirrors the interface of load_pilot_events() but operates on raw 1000 Hz sample data instead of aggregated fixation/saccade/blink events.

Parameters:

subjects (list[int]) – Subject numbers to load (e.g. list(range(1, 23))).
data_path (str) – Root results directory (contains Sub1/, Sub2/, …).
preprocessed (bool) – If True use preprocessed/ subfolder and *_el_samples / *_el_msgs files.

Returns:

explog_df (pd.DataFrame) – Concatenated experimental log across subjects.
samples_df (pd.DataFrame) – Concatenated, trial-enriched gaze samples across subjects. Added columns: subject, trial, recording, sceneID, time_in_trial, block, trial_per_block.