pymovements.dataset.Dataset.deg2pix#

Dataset.deg2pix(pixel_origin: str = 'upper left', position_column: str = 'position', pixel_column: str = 'pixel', verbose: bool = True) → Dataset#

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

This method requires a properly initialized experiment attribute.

After success, the gaze dataframe is extended by the resulting dva columns.

Parameters:

pixel_origin (str) – The desired location of the pixel origin. (default: ‘upper left’) Supported values: center, upper left.
position_column (str) – The input position column name. (default: ‘position’)
pixel_column (str) – The output pixel column name. (default: ‘pixel’)
verbose (bool) – If True, show progress of computation. (default: True)

Returns:

Returns self, useful for method cascading.

Return type:

Dataset

Raises:

AttributeError – If gaze is None or there are no gaze dataframes present in the gaze attribute, or if experiment is None.