NeonRecording

NeonRecording(rec_dir_in: Path | str)

Parameters:

• rec_dir_in (Path | str) –

  Path to the recording directory.

Raises:

• FileNotFoundError –

  If the directory does not exist or is not valid.

• SensorError –

  If accessing a stream that is missing

Methods:

• audio –

  Audio from the scene video

• blinks –

  Blink data

• events –

  Event annotations

• eye –

  Frames of video from the eye cameras

• eyeball –

  Eye state data

• eyelid –

  Eyelid data

• fixations –

  Fixations data

• gaze –

  2D binocular gaze data in scene-camera space

• gaze_monocular_left –

  2D gaze data from the left eye in scene-camera space

• gaze_monocular_right –

  2D gaze data from the right eye in scene-camera space

• imu –

  Motion and orientation data

• pupil –

  Pupil diameter data

• saccades –

  Saccades data

• scene –

  Frames of video from the scene camera

• worn –

  Worn (headset on/off) data

Attributes:

• calibration (Calibration | None) –

  Device camera calibration data

• device_serial (str | None) –

  Device serial number

• duration (int) –

  Recording Duration (nanoseconds)

• id (str | None) –

  UUID of the recording

• info (dict) –

  Information loaded from info.json

• start_time (int) –

  Start timestamp (nanoseconds since 1970-01-01)

• stop_time (int) –

  Stop timestamp (nanoseconds since 1970-01-01)

• wearer (dict) –

  Wearer information containing uuid and name

Source code in src/pupil_labs/neon_recording/neon_recording.py

def __init__(self, rec_dir_in: pathlib.Path | str):
    """Initialize the NeonRecording object

    Args:
        rec_dir_in: Path to the recording directory.

    Raises:
        FileNotFoundError: If the directory does not exist or is not valid.
        NeonRecording.SensorError: If accessing a stream that is missing

    """
    self._rec_dir = UPath(rec_dir_in).resolve()
    if not self._rec_dir.exists() or not self._rec_dir.is_dir():
        raise FileNotFoundError(
            f"Directory not found or not valid: {self._rec_dir}"
        )

calibration cached property

calibration: Calibration | None

Device camera calibration data

device_serial property

device_serial: str | None

Device serial number

duration property

duration: int

Recording Duration (nanoseconds)

id property

id: str | None

UUID of the recording

info cached property

info: dict

Information loaded from info.json

start_time property

start_time: int

Start timestamp (nanoseconds since 1970-01-01)

stop_time property

stop_time: int

Stop timestamp (nanoseconds since 1970-01-01)

wearer cached property

wearer: dict

Wearer information containing uuid and name

audio

audio() -> AudioTimeseries

Audio from the scene video

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def audio(self) -> AudioTimeseries:
    """Audio from the scene video"""
    return AudioTimeseries(self)

blinks

blinks() -> BlinkTimeseries

Blink data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def blinks(self) -> BlinkTimeseries:
    """Blink data"""
    return BlinkTimeseries(self)

events

events() -> EventTimeseries

Event annotations

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def events(self) -> EventTimeseries:
    """Event annotations"""
    return EventTimeseries(self)

eye

eye() -> EyeVideoTimeseries

Frames of video from the eye cameras

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def eye(self) -> EyeVideoTimeseries:
    """Frames of video from the eye cameras"""
    return EyeVideoTimeseries(self)

eyeball

eyeball() -> EyeballTimeseries

Eye state data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def eyeball(self) -> EyeballTimeseries:
    """Eye state data"""
    return EyeballTimeseries(self)

eyelid

eyelid() -> EyelidTimeseries

Eyelid data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def eyelid(self) -> EyelidTimeseries:
    """Eyelid data"""
    return EyelidTimeseries(self)

fixations

fixations() -> FixationTimeseries

Fixations data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def fixations(self) -> FixationTimeseries:
    """Fixations data"""
    return FixationTimeseries(self)

gaze

gaze() -> GazeTimeseries

2D binocular gaze data in scene-camera space

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def gaze(self) -> GazeTimeseries:
    """2D binocular gaze data in scene-camera space"""
    return GazeTimeseries(self)

gaze_monocular_left

gaze_monocular_left() -> GazeLeftTimeseries

2D gaze data from the left eye in scene-camera space

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def gaze_monocular_left(self) -> GazeLeftTimeseries:
    """2D gaze data from the left eye in scene-camera space"""
    return GazeLeftTimeseries(self)

gaze_monocular_right

gaze_monocular_right() -> GazeRightTimeseries

2D gaze data from the right eye in scene-camera space

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def gaze_monocular_right(self) -> GazeRightTimeseries:
    """2D gaze data from the right eye in scene-camera space"""
    return GazeRightTimeseries(self)

imu

imu() -> IMUTimeseries

Motion and orientation data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def imu(self) -> IMUTimeseries:
    """Motion and orientation data"""
    return IMUTimeseries(self)

pupil

pupil() -> PupilTimeseries

Pupil diameter data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def pupil(self) -> PupilTimeseries:
    """Pupil diameter data"""
    return PupilTimeseries(self)

saccades

saccades() -> SaccadeTimeseries

Saccades data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def saccades(self) -> SaccadeTimeseries:
    """Saccades data"""
    return SaccadeTimeseries(self)

scene

scene() -> SceneVideoTimeseries

Frames of video from the scene camera

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def scene(self) -> SceneVideoTimeseries:
    """Frames of video from the scene camera"""
    return SceneVideoTimeseries(self)

worn

worn() -> WornTimeseries

Worn (headset on/off) data

Source code in src/pupil_labs/neon_recording/neon_recording.py

@sensor_loader
def worn(self) -> WornTimeseries:
    """Worn (headset on/off) data"""
    return WornTimeseries(self)

SensorError

Bases: Exception