pymovements.gaze.gaze_dataframe.GazeDataFrame#

class pymovements.gaze.gaze_dataframe.GazeDataFrame(data: pl.DataFrame | None = None, experiment: Experiment | None = None)[source]#

A DataFrame for gaze time series data.

Each row is a sample at a specific timestep. Each column is a channel in the gaze time series.

__init__(data: pl.DataFrame | None = None, experiment: Experiment | None = None)[source]

Initialize a pymovements.gaze.gaze_dataframe.GazeDataFrame.

Parameters:

  • data (pl.DataFrame) – A dataframe to be transformed to a polars dataframe.

  • experiment (Experiment) – The experiment definition.

Methods

__init__([data, experiment])

Initialize a pymovements.gaze.gaze_dataframe.GazeDataFrame.

pix2deg()

Compute gaze positions in degrees of visual angle from pixel position coordinates.

pos2vel([method])

Compute gaze velocites in dva/s from dva position coordinates.

Attributes

columns

List of column names.

pixel_position_columns

Pixel position columns for this dataset.

position_columns

Position columns (in degrees of visual angle) for this dataset.

schema

Schema of event dataframe.

velocity_columns

Velocity columns (in degrees of visual angle per second) of dataframe.