pymovements.utils.parsing.parse_eyelink

pymovements.utils.parsing.parse_eyelink(filepath: Path | str, patterns: list[dict[str, Any] | str] | None = None, schema: dict[str, Any] | None = None, metadata_patterns: list[dict[str, Any] | str] | None = None, encoding: str = 'ascii') → tuple[pl.DataFrame, dict[str, Any]]

Parse EyeLink asc file.

Deprecated since version v0.21.0: Please use from_asc() instead. This module will be removed in v0.26.0.

Parameters:

• filepath (Path | str) – file name of ascii file to convert.

• patterns (list[dict[str, Any] | str] | None) – List of patterns to match for additional columns. (default: None)

• schema (dict[str, Any] | None) – Dictionary to optionally specify types of columns parsed by patterns. (default: None)

• metadata_patterns (list[dict[str, Any] | str] | None) – list of patterns to match for additional metadata. (default: None)

• encoding (str) – Text encoding of the file. (default: ‘ascii’)

Returns:

A tuple containing the parsed sample data and the metadata in a dictionary.

Return type:

tuple[pl.DataFrame, dict[str, Any]]

Raises:

• Warning – If no metadata is found in the file.

• .. deprecated: – v0.21.0: Please use gaze.from_asc() instead. This module will be removed in v0.26.0.